Track Processing API coverage in libprocessing/mewnala

This issue tracks progress toward implementing the Processing API in libprocessing/mewnala.

The goal is to reach broad compatibility with the existing Processing API so that sketches can be ported with minimal friction.

Guidelines

Keywords below are listed using the original Java syntax. Some differences are expected due to the specifics of Python.

Breaking changes should be intentional, and their motivation should be documented in the corresponding issues or PRs.

Definition of done

Mark items as done only once they:

• match the original Processing behavior (see the linked reference page)
• have been validated with example sketches (e.g. in Processing examples, Nature of Code, or the examples directory)
• are included in the latest mewnala release (https://pypi.org/project/mewnala/)

Progress Tracker

[!IMPORTANT]
The list is based on the official Processing reference. This is NOT an exhaustive list of every class, method, or keyword in Processing. Parts of the API are undocumented or listed in individual class pages, see the Methods section of PVector or PImage for example. For a more complete API overview, see the Processing 4 Javadoc.

Data

Composite

• Array
• ArrayList
• FloatDict
• FloatList
• HashMap
• IntDict
• IntList
• JSONArray
• JSONObject
• Object
• String
• StringDict
• StringList
• Table
• TableRow
• XML

Array Functions

• append()
• arrayCopy()
• concat()
• expand()
• reverse()
• shorten()
• sort()
• splice()
• subset()

Conversion

• binary()
• boolean()
• byte()
• char()
• float()
• hex()
• int()
• str()
• unbinary()
• unhex()

Primitive

• boolean
• byte
• char
• color
• double
• float
• int
• long

String Functions

• join()
• matchAll()
• match()
• nf()
• nfc()
• nfp()
• nfs()
• splitTokens()
• split()
• trim()

Input

Files

• BufferedReader
• createInput()
• createReader()
• launch()
• loadBytes()
• loadJSONArray()
• loadJSONObject()
• loadStrings()
• loadXML()
• parseJSONArray()
• parseJSONObject()
• parseXML()
• selectFolder()
• selectInput()
• loadTable()

Time & Date

• day()
• hour()
• millis()
• minute()
• month()
• second()
• year()

Keyboard

• key
• keyCode
• keyPressed
• keyPressed()
• keyReleased()
• keyTyped()

Mouse

• mouseButton
• mouseClicked()
• mouseDragged()
• mouseMoved()
• mousePressed
• mousePressed()
• mouseReleased()
• mouseWheel()
• mouseX
• mouseY
• pmouseX
• pmouseY

Constants

• HALF_PI
• PI
• QUARTER_PI
• TAU
• TWO_PI

Typography

• PFont

Loading & Displaying

• createFont()
• loadFont()
• textFont()
• text()

Attributes

• textAlign()
• textLeading()
• textMode()
• textSize()
• textWidth()

Metrics

• textAscent()
• textDescent()

Rendering

• PGraphics
• blendMode()
• clip()
• createGraphics()
• hint()
• noClip()

Shaders

• PShader
• loadShader()
• resetShader()
• shader()

Image

• PImage
• createImage()

Pixels

• blend()
• copy()
• filter()
• get()
• loadPixels()
• mask()
• pixels[]
• set()
• updatePixels()

Loading & Displaying

• imageMode()
• image()
• loadImage()
• noTint()
• requestImage()
• tint()

Textures

• textureMode()
• textureWrap()
• texture()

Shape

• PShape
• createShape()
• loadShape()

2d primitives

• arc()
• circle()
• ellipse()
• line()
• point()
• quad()
• rect()
• square()
• triangle()

Vertex

• beginContour()
• beginShape()
• bezierVertex()
• curveVertex()
• endContour()
• endShape()
• quadraticVertex()
• vertex()

Curves

• bezierDetail()
• bezierPoint()
• bezierTangent()
• bezier()
• curveDetail()
• curvePoint()
• curveTangent()
• curveTightness()
• curve()

3D Primitives

• box()
• sphereDetail()
• sphere()

Attributes

• ellipseMode()
• rectMode()
• strokeJoin()
• strokeCap()
• strokeWeight()

Loading & Displaying

• shapeMode()
• shape()

Math

• PVector

Calculation

• abs()
• ceil()
• constrain()
• dist()
• exp()
• floor()
• lerp()
• log()
• mag()
• map()
• max()
• min()
• norm()
• pow()
• round()
• sq()
• sqrt()

Trigonometry

• acos()
• asin()
• atan2()
• atan()
• cos()
• degrees()
• radians()
• sin()
• tan()

Operators

• += (add assign)
• + (addition)
• -- (decrement)
• / (divide)
• /= (divide assign)
• ++ (increment)
• - (minus)
• % (modulo)
• * (multiply)
• *= (multiply assign)
• -= (subtract assign)

Bitwise Operators

• & (bitwise AND)
• | (bitwise OR)
• << (left shift)
• >> (right shift)

Random

• noiseDetail()
• noiseSeed()
• noise()
• randomGaussian()
• randomSeed()
• random()

Output

Files

• PrintWriter
• beginRaw()
• beginRecord()
• createOutput()
• createWriter()
• endRaw()
• endRecord()
• saveBytes()
• saveJSONArray()
• saveJSONObject()
• saveStream()
• saveStrings()
• saveTable()
• saveXML()
• selectOutput()

Text Area

• printArray()
• print()
• println()

Image

• saveFrame()
• save()

Color

Creating & Reading

• alpha()
• blue()
• brightness()
• color()
• green()
• hue()
• lerpColor()
• red()
• saturation()

Setting

• background()
• clear()
• colorMode()
• fill()
• noFill()
• noStroke()
• stroke()

Lights Camera

Lights

• ambientLight()
• directionalLight()
• lightFalloff()
• lightSpecular()
• lights()
• noLights()
• normal()
• pointLight()
• spotLight()

Material Properties

• ambient()
• emissive()
• shininess()
• specular()

Camera

• beginCamera()
• camera()
• endCamera()
• frustum()
• ortho()
• perspective()
• printCamera()
• printProjection()

Coordinates

• modelX()
• modelY()
• modelZ()
• screenX()
• screenY()
• screenZ()

Transform

• applyMatrix()
• popMatrix()
• printMatrix()
• pushMatrix()
• resetMatrix()
• rotateX()
• rotateY()
• rotateZ()
• rotate()
• scale()
• shearX()
• shearY()
• translate()

Structure

• [] (array access)
• = (assign)
• catch
• class
• , (comma)
• // (comment)
• {} (curly braces)
• /** */ (doc comment)
• . (dot)
• draw()
• exit()
• extends
• false
• final
• implements
• import
• loop()
• /* */ (multiline comment)
• new
• noLoop()
• null
• () (parentheses)
• popStyle()
• pop()
• private
• public
• pushStyle()
• push()
• redraw()
• return
• ; (semicolon)
• setLocation()
• setResizable()
• setTitle()
• setup()
• static
• super
• this
• thread()
• true
• try
• void

Control

Conditionals

• break
• case
• ?: (conditional)
• continue
• default
• else
• if
• switch

Relational Operators

• == (equality)
• > (greater than)
• >= (greater than or equal to)
• != (inequality)
• < (less than)
• <= (less than or equal to)

Iteration

• for
• while

Logical Operators

• && (logical AND)
• ! (logical NOT)
• || (logical OR)

Environment

• cursor()
• delay()
• displayDensity()
• displayHeight
• displayWidth
• focused
• frameCount
• frameRate
• frameRate()
• fullScreen()
• height
• noCursor()
• noSmooth()
• pixelDensity()
• pixelHeight
• pixelWidth
• settings()
• size()
• smooth()
• width
• windowMove()
• windowMoved()
• windowRatio()
• windowResizable()
• windowResize()
• windowResized()
• windowTitle()

從 Progress Tracker 中未勾選的項目開始，將相關的 Processing 參考頁面或 Javadocs 與目前的 libprocessing/mewnala 實作進行比較。已完成的項目必須符合 Processing 的行為，使用範例 sketch 進行驗證，並包含在最新的 mewnala 版本中。