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()

Bắt đầu với các mục chưa được đánh dấu trong Progress Tracker và so sánh các trang tham chiếu hoặc Javadocs liên quan của Processing với triển khai hiện tại của libprocessing/mewnala. Một mục đã hoàn thành phải khớp với hành vi của Processing, được xác thực bằng một sketch ví dụ và được đưa vào bản phát hành mewnala mới nhất.