RubySketch - Graphics & Games2.12 - App Store

This app includes Ruby language interpreter known as CRuby or MRI (Matz Ruby Implementation) and a simple text editor.
So you can edit and run a ruby script.

It also has an API that is almost compatible with Processing that is well known as a Creative Coding framework.
So you can enjoy graphics programming on your iPhone or iPad.

Key Features
- Built-in Ruby interpreter (CRuby / MRI)
- Processing-compatible graphics API with shaders available
- Built-in text editor that makes moving the cursor painless
- Physics-capable sprites
- Image input from camera
- Sound playback
- Includes many sample scripts, including simple games

This is a list of functions implemented to be compatible with the Processing API.
---
abs, acos, alpha, angleMode, applyMatrix, arc, asin, atan, atan2, background, beginContour, beginShape, bezier, bezierDetail, bezierPoint, bezierTangent, bezierVertex, blend, blendMode, blue, brightness, ceil, circle, clear, clip, color, colorMode, constrain, copy, cos, createCanvas, createCapture, createFont, createGraphics, createImage, createShader, createShape, createVector, curve, curveDetail, curvePoint, curveTangent, curveTightness, curveVertex, degrees, deltaTime, displayDensity, displayHeight, displayWidth, dist, doubleClicked, draw, ellipse, ellipseMode, endContour, endShape, exp, fill, filter, floor, focused, frameCount, frameRate, fullScreen, fullscreen, green, height, hue, image, imageMode, key, keyCode, keyIsDown, keyIsPressed, keyPressed, keyReleased, keyTyped, lerp, lerpColor, line, loadFont, loadImage, loadPixels, loadShader, log, loop, mag, map, max, min, motion, motionGravity, mouseButton, mouseClicked, mouseDragged, mouseMoved, mousePressed, mouseReleased, mouseWheel, mouseX, mouseY, noClip, noFill, noLoop, noSmooth, noStroke, noTint, noise, noiseDetail, noiseSeed, norm, pixelDensity, pixelHeight, pixelWidth, pixels, pmouseX, pmouseY, point, pop, popMatrix, popStyle, pow, printMatrix, push, pushMatrix, pushStyle, quad, quadraticVertex, radians, random, randomGaussian, randomSeed, rect, rectMode, red, redraw, renderMode, requestImage, resetMatrix, resetShader, rotate, rotateX, rotateY, rotateZ, round, saturation, save, scale, setTitle, setup, shader, shape, shapeMode, shearX, shearY, sin, size, smooth, sq, sqrt, square, stroke, strokeCap, strokeJoin, strokeWeight, tan, text, textAlign, textAscent, textDescent, textFont, textLeading, textSize, textWidth, texture, textureMode, textureWrap, tint, touchEnded, touchMoved, touchStarted, touches, translate, triangle, updatePixels, vertex, width, windowHeight, windowMove, windowMoved, windowOrientation, windowResizable, windowResize, windowResized, windowWidth, windowX, windowY

Version History - Updated Ruby version to 4.0.4
- Significantly improved drawing performance
- Up to 5x faster when drawing with a fixed texture or shader
- Added MML (Music Macro Language) support
- Supports tempo, note length, octave, tone, loops, ties, portamento, transpose, detune, and more
- Added Examples/Basics/19_MML.md
- Added mouse and keyboard event support on iOS/iPadOS
- Renamed Sprite#gravity_scale to Sprite#gravityScale
- Fixed an issue where the coordinates of touch UP events could be shifted
- Improved audio dropout prevention during Sound streaming playback 2.12 May 19 - Added "Font Size" menu
- Added "Line Numbers" menu
- Added SpriteWorld class
- Added Vector#-@
- Added functions
- keyIsRepeat
- loadShape()
- Added methods to Shape class
- stroke
- setStroke
- setStrokeWeight
- setStrokeCap
- setStrokeJoin
- Added methods to Sprite class
- keyPressed
- keyReleased
- keyTyped
- key
- keyCode
- keyIsPressed
- keyIsDown
- keyIsRepeated
- capture=
- capturing?
- sensor=
- sensor?
- gravity_scale
- Updated Ruby version from 3.2.2 to 3.3.8
- ellipse() can take 3 parameters
- Rename the join type 'SQUARE' to 'BEVEL'
- createSprite can take 'klass' parameter
- Sprite#hide returns self
- Fixed the issue where Sprite#contactEnd is not working
- Fixed a bug in which the display magnification was fixed at 1x when the size specified by size() was different from the window size and the aspect ratio of both windows was the same
- Fixed that circle() and ellipse() had half diameters 2.11 07/12/2025 - With the support of the Ruby Association Development Grant, the following functions and class have been added
- createShape()
- shape()
- shapeMode()
- beginShape()
- endShape()
- beginContour()
- endContour()
- vertex()
- curveVertex()
- bezierVertex()
- quadraticVertex()
- texture()
- textureMode()
- textureWrap()
- loadPixels()
- updatePixels()
- pixels()
- textLeading()
- createFont()
- loadFont()
- requestImage()
- curveDetail()
- curvePoint()
- curveTangent()
- curveTightness()
- bezierDetail()
- bezierPoint()
- bezierTangent()
- rotateX()
- rotateY()
- rotateZ()
- shearX()
- shearY()
- applyMatrix()
- printMatrix()
- deltaTime
- hue()
- saturation()
- brightness()
- noiseSeed()
- noiseDetail()
- randomSeed()
- randomGaussian()
- fullscreen() (fullScreen())
- smooth()
- noSmooth()
- keyIsDown()
- keyIsPressed()
- mouseWheel()
- doubleClicked()
- Font.list()
- Graphics#clear()
- Graphics#save()
- Shape class
- Added links to the Processing/p5.js documentation in the class and method references
- Added Discord invite link for user support
- Reimplement the noise() for better compatibility
- scale() can take z parameter
- loadImage() raises Net::HTTPClientException instead of OpenURI::HTTPError
- Fixed that pushStyle()/popStyle() did not correctly manage colorMode, angleMode, and blendMode
- Fixed that Ruby documentation is in Japanese 2.10 02/18/2024 - require(), require_relative(), and load() support loading user-created script files
- Manage the folder containing the project.yml file as a project
- Added windowOrientation() function to limit screen rotation
- Added the entire source code of RubySolitaire, which is published as a stand-alone app in AppStore, to Apps/RubySolitaire
- Added Examples/Physics.rb 2.9 07/30/2023 - Fixed a bug that caused the app to crash when an exception occurred in a block set by the following Sprite class methods
- update()
- mousePressed()
- mouseReleased()
- mouseMoved()
- mouseDragged()
- mouseClicked()
- touchStarted()
- touchEnded()
- touchMoved()
- contact()
- contact?() 2.8.1 07/26/2023 - Added these functions
- setTimeout()
- setInterval()
- clearTimer()
- clearTimeout() (aliased to clearTimer())
- clearInterval() (aliased to clearTimer())
- animate()
- animateValue()
- Added a button to show/hide the console on the execution screen
- Maximize button added to console on execution screen
- Improved touch area for full screen cancel button
- Added Examples/Basics/17_Timer.md
- Added Examples/Basics/18_Animation.md 2.8 07/22/2023 - Fixed an issue where both the console background color and text color on the script execution screen were displayed in same white color when using dark mode
- The borders of the Undo and other buttons on the text edit screen were making it difficult to see the body of the text, so they have been made translucent 2.7.1 07/14/2023 - Added Examples/DrumPad.rb
- Added docs for event handling to Examples/Basics/14_Sprite.md
- Added Examples/Basics/15_Physics.md
- Added Examples/Basics/16_Sound.md
- Added a menu to create new markdown file
- Added a menu for setting automatic source code formatting
- Added In-App Purchase for removing ads
- Added RubySolitaire link
- Added functions
- red()
- green()
- blue()
- alpha()
- color()
- lerpColor()
- loadSound()
- focused()
- windowResized()
- Added Sound class
- Added set() and get() to Image class
- Added methods to Sprite class
- draw()
- mousePressed()
- mouseReleased()
- mouseMoved()
- mouseDragged()
- mouseClicked()
- touchStarted()
- touchEnded()
- touchMoved()
- show()
- hide()
- hidden?()
- fixAngle()
- angleFixed?()
- clickCount()
- fromScreen()
- toScreen()
- Added accessors to Sprite class
- left
- top
- right
- bottom
- center
- offset
- angle
- pivot

- The execution screen hides the status bar when full screen
- createGraphics() can take pixelDensity parameter
- copy() and blend() now work with tint color
- colorMode(), angleMode(), and blendMode() returns current mode value
- pushMatrix(), pushStyle(), and push() return the result of the expression at the end of the block when a block given
- pushStyle()/popStyle() do not manage filter state
- mousePressed(), mouseReleased(), mouseMoved(), mouseDragged(), and mouseClicked() ignore multiple touches
- Shader class can take shadertoy frament shader source

- Fixed a case of crash during initialization process at app startup
- Fixed that Vector.random2D() did not work correctly when angleMode() is set to DEGREES
- Fixed that calling mousePressed() without block removes mousePressed block 2.7 07/13/2023 - Added Sprite class
- Added 'Examples/Basics/14_Sprite.md' that briefly explains how to use Sprite class
- Class list and method list are added to the menu
- Ruby version updated from 3.2.0 to 3.2.2 2.6 05/02/2023 - Ruby version updated from 3.1.3 to 3.2.0
- GC.enable() is called when script execution completes
- Added DuelystUnits.rb as sample script
- Fixed a bug that prevented the API reference from being displayed 2.5 02/05/2023 Ruby version updated from 3.1.2 to 3.1.3. 2.4 01/16/2023 - Fixed some issues when running on iOS 16 2.3 01/05/2023 - Added Shader class
- Added these functions
- shader()
- resetShader()
- createShader()
- loadShader()
- filter()
- Added Examples/Basics/13_Shader.md that briefly explains how to use Shader class
- Added Examples/FilterCamera.rb sample script using filter() function
- BUTT and SQUARE were reversed and have been corrected
- Rename BUTT to PROJECT to match the original Processing
- Improved text rendering quality
- setUniform() can also take an array of numbers, a vector, and a texture image
- pushStyle() manages states of textAlign, tint, and filter
- Fixed a bug that pop/popMatrix/popStyle could not be called in certain situations when a block was passed to push/pushMatrix/pushStyle 2.2 12/20/2022 Text Editor Screen
- Improved stability of cursor operation
- Added cut, copy, and paste buttons
- Added button to start text selection
- Hide undo, redo, cut, and copy buttons on iPad

Processing compatible API
- Added these functions: mouseClicked(), blendMode(), blend(), createImage(), save(), clip(), noClick(), tint(), noTint(), setTitle()
- image() function is no longer affected by the value of fill()
- circle() function is now affected by ellipseMode()
- Changed how to draw point by point() function
- strokeCap() and strokeJoin() initial values were changed to ROUND and MITER

Others
- Added Examples/BrightBrush.rb as an example of using blendMode()
- The parent directory of the script file is now the current directory when the script is executed
- Fixed a problem that consumed excessive memory when rotating the screen
- Fixed a bug that could cause undo history to disappear when automatic script formatting was applied 2.1 08/24/2022 - Rebuilt all user interface with SwiftUI
- Fixed many memory leaks

# File List Screen
- Added delete file(s) button
- Added move file(s) button

# Text Editor Screen
- Added new caret moving interface
- Added undo/redo buttons

# Interpreter Screen
- Added full-screen button
- The console no longer hidden in landscape mode

# App Menu
- Added a link to the Ruby reference manual 2.0 07/13/2022 - The built-in CRuby interpreter has been updated to the latest version 3.1.2
- Changed script formatter from RuFo to RuboCop
- Added RandomWalkTriangles.rb as a sample script
- Fixed the black background of the title bar 1.10 05/13/2022 - The built-in CRuby interpreter has been updated to the latest version 3.1.0
- Added Solitaire.rb as a sample script 1.9 01/11/2022 - The built-in CRuby interpreter has been updated to the latest version 3.0.3
- Improved the operability of virtual keys (gamepad)
- Fixed a bug that caused virtual keys to be held down in certain situations
- Added MineSweeper.rb as a sample script 1.8 12/07/2021 - Added Flappy.rb (a FlappyBird clone game) as sample script
- Improved the efficiency of the adjacent block acquisition process of SameGame.rb 1.7 11/24/2021 - Added Shooter.rb (a shooting game) and SameGame.rb (a puzzle game) as sample scripts 1.6 11/17/2021 - Added virtual game pad
- Added keyPressed, keyTyped and keyReleased functions to receive virtual game pad inputs
- Disable swipe back gesture on running script screen
- Fix app launch crach on Apple Silicon Mac 1.5 11/13/2021 - The version of the built-in Ruby interpreter has been updated from 2.7.2 to 3.0.1.
Endless method definition is added.
Like this.
-------------------
def square(x) = x * x 1.4 06/18/2021 - The version of the built-in Ruby interpreter has been updated from 2.6.6 to 2.7.2.
New pattern-matching syntax is now available.
Like this.
-------------------
case {a: 1, b: 2}
in {a:}
p a #=> 1
end 1.3 01/25/2021 - add size(), createCanvas() and pixelDensity() Processing functions
- set strokeWeight to 1 by default for better compatibility with the Processing
- add 'Feedback & Support' menu
- add 'Rate This App' menu
- fix error on loadImage() 1.2 12/17/2020 - add Capture class
- add Examples/DelayCamera.rb 1.1 12/02/2020