4994 lines
177 KiB
Clojure
4994 lines
177 KiB
Clojure
(ns ^{:doc "Wrappers and extensions around the core Processing.org API."}
|
|
quil.core
|
|
#?(:clj
|
|
(:import [processing.core PApplet PImage PGraphics PFont PConstants PShape]
|
|
[processing.opengl PShader]
|
|
[java.awt.event KeyEvent]))
|
|
#?(:clj
|
|
(:require quil.sketch
|
|
[clojure.set]
|
|
[quil.helpers.docs :as docs]
|
|
[quil.util :as u]
|
|
[quil.applet :as ap])
|
|
|
|
:cljs
|
|
(:require clojure.string
|
|
org.processingjs.Processing
|
|
[quil.sketch :as ap :include-macros true]
|
|
[quil.util :as u :include-macros true])))
|
|
|
|
(def ^{:dynamic true
|
|
:private true}
|
|
*graphics* nil)
|
|
|
|
(def ^{:private true} no-fill-prop "no-fill-quil")
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:category "Environment"
|
|
:subcategory nil
|
|
:added "2.0"
|
|
:tag PGraphics}
|
|
current-graphics
|
|
"Graphics currently used for drawing. By default it is sketch graphics,
|
|
but if called inside with-graphics macro - graphics passed to the macro
|
|
is returned. This method should be used if you need to call some methods
|
|
that are not implemented by quil. Example:
|
|
(.beginDraw (current-graphics))."
|
|
[]
|
|
(or *graphics*
|
|
#?(:clj (.-g (ap/current-applet))
|
|
:cljs (ap/current-applet))))
|
|
|
|
;; -------------------- PConstants section -----------------------
|
|
|
|
(u/generate-quil-constants #?(:clj :clj :cljs :cljs)
|
|
arc-modes (:open :chord :pie)
|
|
shape-modes (:points :lines :triangles :triangle-fan :triangle-strip :quads :quad-strip)
|
|
blend-modes (:blend :add :subtract :darkest :lightest :difference :exclusion :multiply
|
|
:screen :overlay :replace :hard-light :soft-light :dodge :burn)
|
|
color-modes (:rgb :hsb)
|
|
image-formats (:rgb :argb :alpha)
|
|
ellipse-modes (:center :radius :corner :corners)
|
|
hint-options (:enable-depth-test :disable-depth-test
|
|
:enable-depth-sort :disable-depth-sort
|
|
:enable-depth-mask :disable-depth-mask
|
|
:enable-opengl-errors :disable-opengl-errors
|
|
:enable-optimized-stroke :disable-optimized-stroke
|
|
:enable-stroke-perspective :disable-stroke-perspective
|
|
:enable-stroke-pure :disable-stroke-pure
|
|
:enable-texture-mipmaps :disable-texture-mipmaps)
|
|
image-modes (:corner :corners :center)
|
|
rect-modes (:corner :corners :center :radius)
|
|
p-shape-modes (:corner :corners :center)
|
|
stroke-cap-modes (:square :round :project :model)
|
|
stroke-join-modes (:miter :bevel :round)
|
|
horizontal-alignment-modes (:left :center :right)
|
|
vertical-alignment-modes (:top :bottom :center :baseline)
|
|
text-modes (:model :shape)
|
|
texture-modes (:image :normal)
|
|
texture-wrap-modes (:clamp :repeat)
|
|
filter-modes (:threshold :gray :invert :posterize :blur :opaque :erode :dilate)
|
|
cursor-modes (:arrow :cross :hand :move :text :wait))
|
|
|
|
;;; Useful trig constants
|
|
#?(:clj (def PI (float Math/PI))
|
|
:cljs (def PI (.-PI js/Math)))
|
|
(def HALF-PI (/ PI (float 2.0)))
|
|
(def THIRD-PI (/ PI (float 3.0)))
|
|
(def QUARTER-PI (/ PI (float 4.0)))
|
|
(def TWO-PI (* PI (float 2.0)))
|
|
|
|
(def DEG-TO-RAD (/ PI (float 180.0)))
|
|
(def RAD-TO-DEG (/ (float 180.0) PI))
|
|
|
|
#?(:clj
|
|
(def ^{:private true}
|
|
KEY-CODES {KeyEvent/VK_UP :up
|
|
KeyEvent/VK_DOWN :down
|
|
KeyEvent/VK_LEFT :left
|
|
KeyEvent/VK_RIGHT :right
|
|
KeyEvent/VK_ALT :alt
|
|
KeyEvent/VK_CONTROL :control
|
|
KeyEvent/VK_SHIFT :shift
|
|
KeyEvent/VK_WINDOWS :command
|
|
KeyEvent/VK_META :command
|
|
KeyEvent/VK_F1 :f1
|
|
KeyEvent/VK_F2 :f2
|
|
KeyEvent/VK_F3 :f3
|
|
KeyEvent/VK_F4 :f4
|
|
KeyEvent/VK_F5 :f5
|
|
KeyEvent/VK_F6 :f6
|
|
KeyEvent/VK_F7 :f7
|
|
KeyEvent/VK_F8 :f8
|
|
KeyEvent/VK_F9 :f9
|
|
KeyEvent/VK_F10 :f10
|
|
KeyEvent/VK_F11 :f11
|
|
KeyEvent/VK_F12 :f12
|
|
KeyEvent/VK_F13 :f13
|
|
KeyEvent/VK_F14 :f14
|
|
KeyEvent/VK_F15 :f15
|
|
KeyEvent/VK_F16 :f16
|
|
KeyEvent/VK_F17 :f17
|
|
KeyEvent/VK_F18 :f18
|
|
KeyEvent/VK_F19 :f19
|
|
KeyEvent/VK_F20 :f20
|
|
KeyEvent/VK_F21 :f21
|
|
KeyEvent/VK_F22 :f22
|
|
KeyEvent/VK_F23 :f23
|
|
KeyEvent/VK_F24 :f24})
|
|
|
|
:cljs
|
|
(def ^{:private true}
|
|
KEY-CODES {38 :up
|
|
40 :down
|
|
37 :left
|
|
39 :right
|
|
18 :alt
|
|
17 :control
|
|
16 :shift
|
|
157 :command
|
|
112 :f1
|
|
113 :f2
|
|
114 :f3
|
|
115 :f4
|
|
116 :f5
|
|
117 :f6
|
|
118 :f7
|
|
119 :f8
|
|
120 :f9
|
|
121 :f10
|
|
122 :f11
|
|
123 :f12}))
|
|
|
|
;; ------------------ end PConstants section ---------------------
|
|
|
|
#?(:cljs
|
|
(defn
|
|
^{:require-bindings true
|
|
:category "Output"
|
|
:subcategory "Text area"
|
|
:added "1.0"}
|
|
prc-println
|
|
"Writes to the text area of the Processing environment's console.
|
|
This is often helpful for looking at the data a program is producing.
|
|
Each call to this function creates a new line of output.
|
|
Individual elements can be separated with quotes (\"\") and joined with the string concatenation operator (+).
|
|
Also writes the content of an array to the text area of the Processing environment.
|
|
This is often helpful for looking at the data a program is producing.
|
|
A new line is put between each element of the array. This function can only print 1D arrays,
|
|
but can test to see if the content are null or not null for 2+ dimensional arrays."
|
|
[msg]
|
|
(.println (ap/current-applet) msg)))
|
|
|
|
#?(:cljs
|
|
(defn
|
|
^{:require-bindings true
|
|
:category "Output"
|
|
:subcategory "Text area"
|
|
:added "1.0"}
|
|
prc-print
|
|
"Writes to the console area of the Processing environment.
|
|
This is often helpful for looking at the data a program is producing.
|
|
The companion function println() works like print(), but creates a new line of text for each call to the function.
|
|
Individual elements can be separated with quotes (\"\") and joined with the addition operator (+). "
|
|
[msg]
|
|
(.print (ap/current-applet) msg)))
|
|
|
|
#?(:cljs
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "getSketchById()"
|
|
:category nil
|
|
:subcategory nil
|
|
:added "1.0"}
|
|
get-sketch-by-id
|
|
"Returns sketch object by id of canvas element of sketch."
|
|
[id]
|
|
(.getInstanceById js/Processing id)))
|
|
|
|
(defmacro with-sketch [applet & body]
|
|
(when-not (u/clj-compilation?)
|
|
`(quil.sketch/with-sketch ~applet ~@body)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:category "State"
|
|
:subcategory nil
|
|
:added "1.0"}
|
|
state-atom
|
|
"Retrieve sketch-specific state-atom. All changes to the
|
|
atom will be reflected in the state.
|
|
|
|
(set-state! :foo 1)
|
|
(state :foo) ;=> 1
|
|
(swap! (state-atom) update-in [:foo] inc)
|
|
(state :foo) ;=> 2"
|
|
#?(:clj ([] (-> (ap/current-applet) meta :state))
|
|
:cljs ([] (. (ap/current-applet) -quil))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:category "State"
|
|
:subcategory nil
|
|
:added "1.0"}
|
|
state
|
|
"Retrieve sketch-specific state by key. Must initially call
|
|
set-state! to store state. If no parameter passed whole
|
|
state map is returned.
|
|
|
|
(set-state! :foo 1)
|
|
(state :foo) ;=> 1
|
|
(state) ;=> {:foo 1}"
|
|
([] @(state-atom))
|
|
|
|
([key] (let [state (state)]
|
|
(when-not (contains? state key)
|
|
(throw #?(:clj (Exception. (str "Unable to find state with key: " key))
|
|
:cljs (js/Error (str "Unable to find state with key: " key)))))
|
|
(get state key))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:category "State"
|
|
:subcategory nil
|
|
:added "1.0"}
|
|
set-state!
|
|
"Set sketch-specific state. May only be called once (ideally in the
|
|
setup fn). Subsequent calls have no effect.
|
|
|
|
Example:
|
|
(set-state! :foo 1 :bar (atom true) :baz (/ (width) 2))"
|
|
[& state-vals]
|
|
(let [state* (state-atom)]
|
|
(when-not @state*
|
|
(let [state-map (apply hash-map state-vals)]
|
|
(reset! state* state-map)))))
|
|
|
|
#?(:clj
|
|
(defn
|
|
^{:requires-bindings false
|
|
:processing-name "abs()"
|
|
:category "Math"
|
|
:subcategory "Calculation"
|
|
:added "1.0"}
|
|
abs-int
|
|
"Calculates the absolute value (magnitude) of a number. The absolute
|
|
value of a number is always positive. Takes and returns an int."
|
|
[n]
|
|
(PApplet/abs (int n))))
|
|
|
|
#?(:clj
|
|
(defn
|
|
^{:requires-bindings false
|
|
:processing-name "abs()"
|
|
:category "Math"
|
|
:subcategory "Calculation"
|
|
:added "1.0"}
|
|
abs-float
|
|
"Calculates the absolute value (magnitude) of a number. The absolute
|
|
value of a number is always positive. Takes and returns a float."
|
|
[n]
|
|
(PApplet/abs (float n))))
|
|
|
|
|
|
(defn
|
|
^{:requires-bindings false
|
|
:processing-name "abs()"
|
|
:category "Math"
|
|
:subcategory "Calculation"
|
|
:added "1.0"}
|
|
abs
|
|
"Calculates the absolute value (magnitude) of a number. The
|
|
absolute value of a number is always positive. Dynamically casts to
|
|
an int or float appropriately"
|
|
[n]
|
|
#?(:clj
|
|
(if (u/int-like? n)
|
|
(abs-int n)
|
|
(abs-float n))
|
|
:cljs
|
|
(.abs (ap/current-applet) n)))
|
|
|
|
(defn
|
|
^{:requires-bindings false
|
|
:processing-name "acos()"
|
|
:category "Math"
|
|
:subcategory "Trigonometry"
|
|
:added "1.0"}
|
|
acos
|
|
"The inverse of cos, returns the arc cosine of a value. This
|
|
function expects the values in the range of -1 to 1 and values are
|
|
returned in the range 0 to Math/PI (3.1415927)."
|
|
[n]
|
|
#?(:clj (PApplet/acos (float n))
|
|
:cljs (.acos (ap/current-applet) n)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "alpha()"
|
|
:category "Color"
|
|
:subcategory "Creating & Reading"
|
|
:added "1.0"}
|
|
alpha
|
|
"Extracts the alpha value from a color."
|
|
[color]
|
|
(.alpha (current-graphics) (unchecked-int color)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "ambient()"
|
|
:category "Lights, Camera"
|
|
:subcategory "Material Properties"
|
|
:added "1.0"}
|
|
ambient-float
|
|
"Sets the ambient reflectance for shapes drawn to the screen. This
|
|
is combined with the ambient light component of environment. The
|
|
color components set through the parameters define the
|
|
reflectance. For example in the default color mode, setting x=255,
|
|
y=126, z=0, would cause all the red light to reflect and half of the
|
|
green light to reflect. Used in combination with emissive, specular,
|
|
and shininess in setting the material properties of shapes."
|
|
([gray] (.ambient (current-graphics) (float gray)))
|
|
([x y z] (.ambient (current-graphics) (float x) (float y) (float z))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "ambient()"
|
|
:category "Lights, Camera"
|
|
:subcategory "Material Properties"
|
|
:added "1.0"}
|
|
ambient-int
|
|
"Sets the ambient reflectance for shapes drawn to the screen. This
|
|
is combined with the ambient light component of environment. The rgb
|
|
color components set define the reflectance. Used in combination
|
|
with emissive, specular, and shininess in setting the material
|
|
properties of shapes."
|
|
[rgb]
|
|
(.ambient (current-graphics) (int rgb)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "ambient()"
|
|
:category "Lights, Camera"
|
|
:subcategory "Material Properties"
|
|
:added "1.0"}
|
|
ambient
|
|
"Sets the ambient reflectance for shapes drawn to the screen. This
|
|
is combined with the ambient light component of environment. The
|
|
color components set through the parameters define the
|
|
reflectance. For example in the default color mode, setting x=255,
|
|
y=126, z=0, would cause all the red light to reflect and half of the
|
|
green light to reflect. Used in combination with emissive, specular,
|
|
and shininess in setting the material properties of shapes."
|
|
([rgb]
|
|
#?(:clj (if (u/int-like? rgb) (ambient-int rgb) (ambient-float rgb))
|
|
:cljs (ambient-float rgb)))
|
|
([x y z] (ambient-float x y z)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "ambientLight()"
|
|
:category "Lights, Camera"
|
|
:subcategory "Lights"
|
|
:added "1.0"}
|
|
ambient-light
|
|
"Adds an ambient light. Ambient light doesn't come from a specific direction,
|
|
the rays have light have bounced around so much that objects are
|
|
evenly lit from all sides. Ambient lights are almost always used in
|
|
combination with other types of lights. Lights need to be included
|
|
in the draw to remain persistent in a looping program. Placing them
|
|
in the setup of a looping program will cause them to only have an
|
|
effect the first time through the loop. The effect of the
|
|
parameters is determined by the current color mode."
|
|
([red green blue]
|
|
(.ambientLight (current-graphics) (float red) (float green) (float blue)))
|
|
([red green blue x y z]
|
|
(.ambientLight (current-graphics) (float red) (float green) (float blue)
|
|
(float x) (float y) (float z))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "applyMatrix()"
|
|
:category "Transform"
|
|
:subcategory nil
|
|
:added "1.0"}
|
|
apply-matrix
|
|
"Multiplies the current matrix by the one specified through the
|
|
parameters. This is very slow because it will try to calculate the
|
|
inverse of the transform, so avoid it whenever possible. The
|
|
equivalent function in OpenGL is glMultMatrix()."
|
|
#?(:clj
|
|
([n00 n01 n02 n10 n11 n12]
|
|
(.applyMatrix (current-graphics)
|
|
(float n00) (float n01) (float n02)
|
|
(float n10) (float n11) (float n12))))
|
|
([n00 n01 n02 n03
|
|
n10 n11 n12 n13
|
|
n20 n21 n22 n23
|
|
n30 n31 n32 n33]
|
|
(.applyMatrix (current-graphics)
|
|
(float n00) (float n01) (float n02) (float n03)
|
|
(float n10) (float n11) (float n12) (float n13)
|
|
(float n20) (float n21) (float n22) (float n23)
|
|
(float n30) (float n31) (float n32) (float n33))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "arc()"
|
|
:category "Shape"
|
|
:subcategory "2D Primitives"
|
|
:added "1.0"}
|
|
arc
|
|
"Draws an arc in the display window. Arcs are drawn along the outer
|
|
edge of an ellipse defined by the x, y, width and height
|
|
parameters. The origin or the arc's ellipse may be changed with the
|
|
ellipse-mode function. The start and stop parameters specify the
|
|
angles at which to draw the arc. The mode is either :open, :chord or :pie."
|
|
([x y width height start stop]
|
|
(.arc (current-graphics) (float x) (float y) (float width) (float height)
|
|
(float start) (float stop)))
|
|
|
|
#?(:clj
|
|
([x y width height start stop mode]
|
|
(let [arc-mode (u/resolve-constant-key mode arc-modes)]
|
|
(.arc (current-graphics) (float x) (float y) (float width) (float height)
|
|
(float start) (float stop) (int arc-mode))))))
|
|
|
|
(defn
|
|
^{:requires-bindings false
|
|
:processing-name "asin()"
|
|
:category "Math"
|
|
:subcategory "Trigonometry"
|
|
:added "1.0"}
|
|
asin
|
|
"The inverse of sin, returns the arc sine of a value. This function
|
|
expects the values in the range of -1 to 1 and values are returned
|
|
in the range -PI/2 to PI/2."
|
|
[n]
|
|
#?(:clj (PApplet/asin (float n))
|
|
:cljs (.asin (ap/current-applet) n)))
|
|
|
|
(defn
|
|
^{:requires-bindings false
|
|
:processing-name "atan()"
|
|
:category "Math"
|
|
:subcategory "Trigonometry"
|
|
:added "1.0"}
|
|
atan
|
|
"The inverse of tan, returns the arc tangent of a value. This
|
|
function expects the values in the range of -Infinity to
|
|
Infinity (exclusive) and values are returned in the range -PI/2 to
|
|
PI/2 ."
|
|
[n]
|
|
#?(:clj (PApplet/atan (float n))
|
|
:cljs (.atan (ap/current-applet) n)))
|
|
|
|
(defn
|
|
^{:requires-bindings false
|
|
:processing-name "atan2()"
|
|
:category "Math"
|
|
:subcategory "Trigonometry"
|
|
:added "1.0"}
|
|
atan2
|
|
"Calculates the angle (in radians) from a specified point to the
|
|
coordinate origin as measured from the positive x-axis. Values are
|
|
returned as a float in the range from PI to -PI. The atan2 function
|
|
is most often used for orienting geometry to the position of the
|
|
cursor. Note: The y-coordinate of the point is the first parameter
|
|
and the x-coordinate is the second due to the structure of
|
|
calculating the tangent."
|
|
[y x]
|
|
#?(:clj (PApplet/atan2 (float y) (float x))
|
|
:cljs (.atan2 (ap/current-applet) y x)))
|
|
|
|
(defn
|
|
^{:requires-bindings false
|
|
:processing-name "PFont.list()"
|
|
:category "Typography"
|
|
:subcategory "Loading & Displaying"
|
|
:added "1.0"}
|
|
available-fonts
|
|
"A sequence of strings representing the fonts on this system
|
|
available for use.
|
|
|
|
Because of limitations in Java, not all fonts can be used and some
|
|
might work with one operating system and not others. When sharing a
|
|
sketch with other people or posting it on the web, you may need to
|
|
include a .ttf or .otf version of your font in the data directory of
|
|
the sketch because other people might not have the font installed on
|
|
their computer. Only fonts that can legally be distributed should be
|
|
included with a sketch."
|
|
[]
|
|
#?(:clj (seq (PFont/list))
|
|
:cljs (seq (.list js/PFont))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "background()"
|
|
:category "Color"
|
|
:subcategory "Setting"
|
|
:added "1.0"}
|
|
background-float
|
|
"Sets the color used for the background of the Processing
|
|
window. The default background is light gray. In the draw function,
|
|
the background color is used to clear the display window at the
|
|
beginning of each frame.
|
|
|
|
It is not possible to use transparency (alpha) in background colors
|
|
with the main drawing surface, however they will work properly with
|
|
create-graphics. Converts args to floats."
|
|
([gray] (.background (current-graphics) (float gray)))
|
|
([gray alpha] (.background (current-graphics) (float gray) (float alpha)))
|
|
([r g b] (.background (current-graphics) (float r) (float g) (float b)))
|
|
([r g b a] (.background (current-graphics) (float r) (float g) (float b) (float a))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "background()"
|
|
:category "Color"
|
|
:subcategory "Setting"
|
|
:added "1.0"}
|
|
background-int
|
|
"Sets the color used for the background of the Processing
|
|
window. The default background is light gray. In the draw function,
|
|
the background color is used to clear the display window at the
|
|
beginning of each frame.
|
|
|
|
It is not possible to use transparency (alpha) in background colors
|
|
with the main drawing surface, however they will work properly with
|
|
create-graphics. Converts rgb to an int and alpha to a float."
|
|
([rgb] (.background (current-graphics) (unchecked-int rgb)))
|
|
([rgb alpha] (.background (current-graphics) (unchecked-int rgb) (float alpha))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "background()"
|
|
:category "Color"
|
|
:subcategory "Setting"
|
|
:added "1.0"}
|
|
background
|
|
"Sets the color used for the background of the Processing
|
|
window. The default background is light gray. In the draw function,
|
|
the background color is used to clear the display window at the
|
|
beginning of each frame.
|
|
|
|
It is not possible to use transparency (alpha) in background colors
|
|
with the main drawing surface, however they will work properly with
|
|
create-graphics. Converts args to floats."
|
|
#?(:clj ([rgb] (if (u/int-like? rgb) (background-int rgb) (background-float rgb)))
|
|
:cljs ([rgb] (.background (current-graphics) rgb)))
|
|
#?(:clj ([rgb alpha] (if (u/int-like? rgb) (background-int rgb alpha) (background-float rgb alpha)))
|
|
:cljs ([rgb alpha] (.background (current-graphics) rgb alpha)))
|
|
([r g b] (background-float r g b))
|
|
([r g b a] (background-float r g b a)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "background()"
|
|
:category "Color"
|
|
:subcategory "Setting"
|
|
:added "1.0"}
|
|
background-image
|
|
"Specify an image to be used as the background for a sketch. Its
|
|
width and height must be the same size as the sketch window. Images
|
|
used as background will ignore the current tint setting."
|
|
[^PImage img]
|
|
(.background (current-graphics) img))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "beginCamera()"
|
|
:category "Lights, Camera"
|
|
:subcategory "Camera"
|
|
:added "1.0"}
|
|
begin-camera
|
|
"Sets the matrix mode to the camera matrix so calls such as
|
|
translate, rotate, apply-matrix and reset-matrix affect the
|
|
camera. begin-camera should always be used with a following
|
|
end-camera and pairs of begin-camera and end-camera cannot be
|
|
nested.
|
|
|
|
For most situations the camera function will be sufficient."
|
|
[]
|
|
(.beginCamera (current-graphics)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "beginContour()"
|
|
:category "Shape"
|
|
:subcategory "Vertex"
|
|
:added "2.0"}
|
|
begin-contour
|
|
"Use the begin-contour and end-contour function to create negative
|
|
shapes within shapes. These functions can only be within a
|
|
begin-shape/end-shape pair and they only work with the :p2d and :p3d
|
|
renderers."
|
|
[]
|
|
(.beginContour (current-graphics)))
|
|
|
|
#?(:clj
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "beginRaw()"
|
|
:category "Output"
|
|
:subcategory "Files"
|
|
:added "1.0"}
|
|
begin-raw
|
|
"Enables the creation of vectors from 3D data. Requires
|
|
corresponding end-raw command. These commands will grab the shape
|
|
data just before it is rendered to the screen. At this stage, your
|
|
entire scene is nothing but a long list of individual lines and
|
|
triangles. This means that a shape created with sphere method will
|
|
be made up of hundreds of triangles, rather than a single object. Or
|
|
that a multi-segment line shape (such as a curve) will be rendered
|
|
as individual segments."
|
|
([renderer filename]
|
|
(.beginRaw (ap/current-applet) (ap/resolve-renderer renderer) (u/absolute-path filename)))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "beginShape()"
|
|
:category "Shape"
|
|
:subcategory "Vertex"
|
|
:added "1.0"}
|
|
begin-shape
|
|
"Enables the creation of complex forms. begin-shape begins recording
|
|
vertices for a shape and end-shape stops recording. Use the mode
|
|
keyword to specify which shape create from the provided
|
|
vertices. With no mode specified, the shape can be any irregular
|
|
polygon.
|
|
|
|
The available mode keywords are :points, :lines, :triangles,
|
|
:triangle-fan, :triangle-strip,
|
|
:quads, :quad-strip.
|
|
|
|
After calling the begin-shape function, a series of vertex commands
|
|
must follow. To stop drawing the shape, call end-shape. The vertex
|
|
function with two parameters specifies a position in 2D and the
|
|
vertex function with three parameters specifies a position in
|
|
3D. Each shape will be outlined with the current stroke color and
|
|
filled with the fill color.
|
|
|
|
Transformations such as translate, rotate, and scale do not work
|
|
within begin-shape. It is also not possible to use other shapes,
|
|
such as ellipse or rect within begin-shape."
|
|
([] (.beginShape (current-graphics)))
|
|
([mode]
|
|
(let [mode (u/resolve-constant-key mode shape-modes)]
|
|
(.beginShape (current-graphics) (int mode)))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "bezier()"
|
|
:category "Shape"
|
|
:subcategory "Curves"
|
|
:added "1.0"}
|
|
bezier
|
|
"Draws a Bezier curve on the screen. These curves are defined by a
|
|
series of anchor and control points. The first two parameters
|
|
specify the first anchor point and the last two parameters specify
|
|
the other anchor point. The middle parameters specify the control
|
|
points which define the shape of the curve."
|
|
([x1 y1 cx1 cy1 cx2 cy2 x2 y2]
|
|
(.bezier (current-graphics)
|
|
(float x1) (float y1)
|
|
(float cx1) (float cy1)
|
|
(float cx2) (float cy2)
|
|
(float x2) (float y2)))
|
|
([x1 y1 z1 cx1 cy1 cz1 cx2 cy2 cz2 x2 y2 z2]
|
|
(.bezier (current-graphics)
|
|
(float x1) (float y1) (float z1)
|
|
(float cx1) (float cy1) (float cz1)
|
|
(float cx2) (float cy2) (float cz2)
|
|
(float x2) (float y2) (float z2))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "bezierDetail()"
|
|
:category "Shape"
|
|
:subcategory "Curves"
|
|
:added "1.0"}
|
|
bezier-detail
|
|
"Sets the resolution at which Beziers display. The default value is
|
|
20. This function is only useful when using the :p3d or :opengl
|
|
renderer as the default (:java2d) renderer does not use this
|
|
information."
|
|
[detail]
|
|
(.bezierDetail (current-graphics) (int detail)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "bezierPoint()"
|
|
:category "Shape"
|
|
:subcategory "Curves"
|
|
:added "1.0"}
|
|
bezier-point
|
|
"Evaluates the Bezier at point t for points a, b, c, d. The
|
|
parameter t varies between 0 and 1, a and d are points on the curve,
|
|
and b and c are the control points. This can be done once with the x
|
|
coordinates and a second time with the y coordinates to get the
|
|
location of a bezier curve at t."
|
|
[a b c d t]
|
|
(.bezierPoint (current-graphics) (float a) (float b) (float c)
|
|
(float d) (float t)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "bezierTangent()"
|
|
:category "Shape"
|
|
:subcategory "Curves"
|
|
:added "1.0"}
|
|
bezier-tangent
|
|
"Calculates the tangent of a point on a Bezier curve.
|
|
(See http://en.wikipedia.org/wiki/Tangent)"
|
|
[a b c d t]
|
|
(.bezierTangent (current-graphics) (float a) (float b) (float c)
|
|
(float d) (float t)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "bezierVertex()"
|
|
:category "Shape"
|
|
:subcategory "Vertex"
|
|
:added "1.0"}
|
|
bezier-vertex
|
|
"Specifies vertex coordinates for Bezier curves. Each call to
|
|
bezier-vertex defines the position of two control points and one
|
|
anchor point of a Bezier curve, adding a new segment to a line or
|
|
shape. The first time bezier-vertex is used within a begin-shape
|
|
call, it must be prefaced with a call to vertex to set the first
|
|
anchor point. This function must be used between begin-shape and
|
|
end-shape and only when there is no parameter specified to
|
|
begin-shape."
|
|
([cx1 cy1 cx2 cy2 x y]
|
|
(.bezierVertex (current-graphics)
|
|
(float cx1) (float cy1)
|
|
(float cx2) (float cy2)
|
|
(float x) (float y)))
|
|
([cx1 cy1 cz1 cx2 cy2 cz2 x y z]
|
|
(.bezierVertex (current-graphics)
|
|
(float cx1) (float cy1) (float cz1)
|
|
(float cx2) (float cy2) (float cz2)
|
|
(float x) (float y) (float z))))
|
|
|
|
(defn
|
|
^{:require-binding false
|
|
:processing-name "binary()"
|
|
:category "Data"
|
|
:subcategory "Conversion"
|
|
:added "1.0"}
|
|
binary
|
|
"Returns a string representing the binary value of an int, char or
|
|
byte. When converting an int to a string, it is possible to specify
|
|
the number of digits used."
|
|
([val]
|
|
#?(:clj (PApplet/binary (int val))
|
|
:cljs (.binary (ap/current-applet) val)))
|
|
([val num-digits]
|
|
#?(:clj (PApplet/binary (int val) (int num-digits))
|
|
:cljs (.binary (ap/current-applet) val num-digits))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "blend()"
|
|
:category "Image"
|
|
:subcategory "Pixels"
|
|
:added "1.0"}
|
|
blend
|
|
"Blends a region of pixels from one image into another with full alpha
|
|
channel support. If src is not specified it defaults to current-graphics.
|
|
If dest is not specified it defaults to current-graphics.
|
|
|
|
Note: blend-mode function is recommended to use instead of this one.
|
|
|
|
Available blend modes are:
|
|
|
|
:blend - linear interpolation of colours: C = A*factor + B
|
|
:add - additive blending with white clip:
|
|
C = min(A*factor + B, 255)
|
|
:subtract - subtractive blending with black clip:
|
|
C = max(B - A*factor, 0)
|
|
:darkest - only the darkest colour succeeds:
|
|
C = min(A*factor, B)
|
|
:lightest - only the lightest colour succeeds:
|
|
C = max(A*factor, B)
|
|
:difference - subtract colors from underlying image.
|
|
:exclusion - similar to :difference, but less extreme.
|
|
:multiply - Multiply the colors, result will always be darker.
|
|
:screen - Opposite multiply, uses inverse values of the colors.
|
|
:overlay - A mix of :multiply and :screen. Multiplies dark values
|
|
and screens light values.
|
|
:hard-light - :screen when greater than 50% gray, :multiply when
|
|
lower.
|
|
:soft-light - Mix of :darkest and :lightest. Works like :overlay,
|
|
but not as harsh.
|
|
:dodge - Lightens light tones and increases contrast, ignores
|
|
darks.
|
|
Called \"Color Dodge\" in Illustrator and Photoshop.
|
|
:burn - Darker areas are applied, increasing contrast, ignores
|
|
lights. Called \"Color Burn\" in Illustrator and
|
|
Photoshop."
|
|
([x y width height dx dy dwidth dheight mode]
|
|
(blend (current-graphics) (current-graphics) x y width height dx dy dwidth dheight mode))
|
|
([^PImage src-img x y width height dx dy dwidth dheight mode]
|
|
(blend src-img (current-graphics) x y width height dx dy dwidth dheight mode))
|
|
([^PImage src-img ^PImage dest-img x y width height dx dy dwidth dheight mode]
|
|
(let [mode (u/resolve-constant-key mode blend-modes)]
|
|
(.blend dest-img src-img (int x) (int y) (int width) (int height)
|
|
(int dx) (int dy) (int dwidth) (int dheight) (int mode)))))
|
|
|
|
(defn
|
|
^{:requires-bindings false
|
|
:processing-name "blendColor()"
|
|
:processing-link nil
|
|
:category "Color"
|
|
:subcategory "Creating & Reading"
|
|
:added "1.0"}
|
|
blend-color
|
|
"Blends two color values together based on the blending mode given specified
|
|
with the mode keyword.
|
|
|
|
Available blend modes are:
|
|
|
|
:blend - linear interpolation of colours: C = A*factor + B
|
|
:add - additive blending with white clip:
|
|
C = min(A*factor + B, 255)
|
|
:subtract - subtractive blending with black clip:
|
|
C = max(B - A*factor, 0)
|
|
:darkest - only the darkest colour succeeds:
|
|
C = min(A*factor, B)
|
|
:lightest - only the lightest colour succeeds:
|
|
C = max(A*factor, B)
|
|
:difference - subtract colors from underlying image.
|
|
:exclusion - similar to :difference, but less extreme.
|
|
:multiply - Multiply the colors, result will always be darker.
|
|
:screen - Opposite multiply, uses inverse values of the colors.
|
|
:overlay - A mix of :multiply and :screen. Multiplies dark values
|
|
and screens light values.
|
|
:hard-light - :screen when greater than 50% gray, :multiply when
|
|
lower.
|
|
:soft-light - Mix of :darkest and :lightest. Works like :overlay,
|
|
but not as harsh.
|
|
:dodge - Lightens light tones and increases contrast, ignores
|
|
darks.
|
|
Called \"Color Dodge\" in Illustrator and Photoshop.
|
|
:burn - Darker areas are applied, increasing contrast, ignores
|
|
lights. Called \"Color Burn\" in Illustrator and
|
|
Photoshop."
|
|
[c1 c2 mode]
|
|
(let [mode (u/resolve-constant-key mode blend-modes)]
|
|
#?(:clj (PApplet/blendColor (unchecked-int c1) (unchecked-int c2) (int mode))
|
|
:cljs (.blendColor (current-graphics) c1 c2 mode))))
|
|
|
|
#?(:clj
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "blendMode()"
|
|
:category "Image"
|
|
:subcategory "Rendering"
|
|
:added "2.0"}
|
|
blend-mode
|
|
"Blends the pixels in the display window according to the defined mode.
|
|
There is a choice of the following modes to blend the source pixels (A)
|
|
with the ones of pixels already in the display window (B):
|
|
|
|
:blend - linear interpolation of colours: C = A*factor + B
|
|
:add - additive blending with white clip:
|
|
C = min(A*factor + B, 255)
|
|
:subtract - subtractive blending with black clip:
|
|
C = max(B - A*factor, 0)
|
|
:darkest - only the darkest colour succeeds:
|
|
C = min(A*factor, B)
|
|
:lightest - only the lightest colour succeeds:
|
|
C = max(A*factor, B)
|
|
:exclusion - similar to :difference, but less extreme.
|
|
:multiply - Multiply the colors, result will always be darker.
|
|
:screen - Opposite multiply, uses inverse values of the colors.
|
|
:replace - the pixels entirely replace the others and don't utilize
|
|
alpha (transparency) values
|
|
|
|
Note: :hard-light, :soft-light, :dodge, :overlay, :dodge, :burn, :difference
|
|
modes are not supported by this function.
|
|
|
|
factor is alpha value of pixel being drawed"
|
|
([mode]
|
|
(let [mode (u/resolve-constant-key mode blend-modes)]
|
|
(.blendMode (current-graphics) mode)))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "blue()"
|
|
:category "Color"
|
|
:subcategory "Creating & Reading"
|
|
:added "1.0"}
|
|
blue
|
|
"Extracts the blue value from a color, scaled to match current color-mode.
|
|
Returns a float."
|
|
[color]
|
|
(.blue (current-graphics) (unchecked-int color)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "box()"
|
|
:category "Shape"
|
|
:subcategory "3D Primitives"
|
|
:added "1.0"}
|
|
box
|
|
"Creates an extruded rectangle."
|
|
([size] (.box (current-graphics) (float size)))
|
|
([width height depth] (.box (current-graphics) (float width) (float height) (float depth))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "brightness()"
|
|
:category "Color"
|
|
:subcategory "Creating & Reading"
|
|
:added "1.0"}
|
|
brightness
|
|
"Extracts the brightness value from a color. Returns a float."
|
|
[color]
|
|
(.brightness (current-graphics) (unchecked-int color)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "camera()"
|
|
:category "Lights, Camera"
|
|
:subcategory "Camera"
|
|
:added "1.0"}
|
|
camera
|
|
"Sets the position of the camera through setting the eye position,
|
|
the center of the scene, and which axis is facing upward. Moving the
|
|
eye position and the direction it is pointing (the center of the
|
|
scene) allows the images to be seen from different angles. The
|
|
version without any parameters sets the camera to the default
|
|
position, pointing to the center of the display window with the Y
|
|
axis as up. The default values are:
|
|
|
|
eyeX: (/ (width) 2.0)
|
|
eyeY: (/ (height) 2.0)
|
|
eyeZ: (/ (/ (height) 2.0) (tan (/ (* Math/PI 60.0) 360.0)))
|
|
centerX: (/ (width) 2.0)
|
|
centerY: (/ (height) 2.0)
|
|
centerZ: 0
|
|
upX: 0
|
|
upY: 1
|
|
upZ: 0
|
|
|
|
Similar imilar to gluLookAt() in OpenGL, but it first clears the
|
|
current camera settings."
|
|
([] (.camera (current-graphics)))
|
|
([eyeX eyeY eyeZ centerX centerY centerZ upX upY upZ]
|
|
(.camera (current-graphics) (float eyeX) (float eyeY) (float eyeZ)
|
|
(float centerX) (float centerY) (float centerZ)
|
|
(float upX) (float upY) (float upZ))))
|
|
|
|
(defn
|
|
^{:requires-bindings false
|
|
:processing-name "ceil()"
|
|
:category "Math"
|
|
:subcategory "Calculation"
|
|
:added "1.0"}
|
|
ceil
|
|
"Calculates the closest int value that is greater than or equal to
|
|
the value of the parameter. For example, (ceil 9.03) returns the
|
|
value 10."
|
|
[n]
|
|
#?(:clj (PApplet/ceil (float n))
|
|
:cljs (.ceil (ap/current-applet) n)))
|
|
|
|
#?(:clj
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "clear()"
|
|
:category "Color"
|
|
:subcategory "Setting"
|
|
:added "2.4.0"}
|
|
clear
|
|
"Clears the pixels within a buffer. This function only works on
|
|
graphics objects created with the (create-graphics) function meaning
|
|
that you should call it only inside (with-graphics) macro. Unlike
|
|
the main graphics context (the display window), pixels in additional
|
|
graphics areas created with (create-graphics) can be entirely or
|
|
partially transparent. This function clears everything in a graphics
|
|
object to make all of the pixels 100% transparent."
|
|
[]
|
|
(.clear (current-graphics))))
|
|
|
|
#?(:clj
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "clip()"
|
|
:category "Rendering"
|
|
:subcategory nil
|
|
:added "2.4.0"}
|
|
clip
|
|
"Limits the rendering to the boundaries of a rectangle defined by
|
|
the parameters. The boundaries are drawn based on the state of
|
|
the (image-mode) fuction, either :corner, :corners, or :center.
|
|
To disable use (no-clip)."
|
|
[x y w h]
|
|
(.clip (current-graphics) (float x) (float y) (float w) (float h))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "color()"
|
|
:category "Color"
|
|
:subcategory "Creating & Reading"
|
|
:added "1.0"}
|
|
color
|
|
"Creates an integer representation of a color The parameters are
|
|
interpreted as RGB or HSB values depending on the current
|
|
color-mode. The default mode is RGB values from 0 to 255 and
|
|
therefore, the function call (color 255 204 0) will return a bright
|
|
yellow. Args are cast to floats.
|
|
|
|
r - red or hue value
|
|
g - green or saturation value
|
|
b - blue or brightness value
|
|
a - alpha value"
|
|
([gray] (.color (current-graphics) (float gray)))
|
|
([gray alpha] (.color (current-graphics) (float gray) (float alpha)))
|
|
([r g b] (.color (current-graphics) (float r) (float g) (float b)))
|
|
([r g b a] (.color (current-graphics) (float r) (float g) (float b) (float a))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "colorMode()"
|
|
:category "Color"
|
|
:subcategory "Creating & Reading"
|
|
:added "1.0"}
|
|
color-mode
|
|
"Changes the way Processing interprets color data. Available modes
|
|
are :rgb and :hsb.By default, the parameters for fill, stroke,
|
|
background, and color are defined by values between 0 and 255 using
|
|
the :rgb color model. The color-mode fn is used to change the
|
|
numerical range used for specifying colors and to switch color
|
|
systems. For example, calling
|
|
(color-mode :rgb 1.0) will specify that values are specified between
|
|
0 and 1. The limits for defining colors are altered by setting the
|
|
parameters range1, range2, range3, and range 4."
|
|
([mode]
|
|
(let [mode (u/resolve-constant-key mode color-modes)]
|
|
(.colorMode (current-graphics) (int mode))))
|
|
([mode max]
|
|
(let [mode (u/resolve-constant-key mode color-modes)]
|
|
(.colorMode (current-graphics) (int mode) (float max))))
|
|
([mode max-x max-y max-z]
|
|
(let [mode (u/resolve-constant-key mode color-modes)]
|
|
(.colorMode (current-graphics) (int mode) (float max-x) (float max-y) (float max-z))))
|
|
([mode max-x max-y max-z max-a]
|
|
(let [mode (u/resolve-constant-key mode color-modes)]
|
|
(.colorMode (current-graphics) (int mode) (float max-x) (float max-y) (float max-z) (float max-a)))))
|
|
|
|
#?(:clj
|
|
(defn
|
|
^{:requires-bindings false
|
|
:processing-name "constrain()"
|
|
:category "Math"
|
|
:subcategory "Calculation"
|
|
:added "1.0"}
|
|
constrain-float
|
|
"Constrains a value to not exceed a maximum and minimum value. All
|
|
args are cast to floats."
|
|
[amt low high]
|
|
(PApplet/constrain (float amt) (float low) (float high))))
|
|
|
|
#?(:clj
|
|
(defn
|
|
^{:requires-bindings false
|
|
:processing-name "constrain()"
|
|
:category "Math"
|
|
:subcategory "Calculation"
|
|
:added "1.0"}
|
|
constrain-int
|
|
"Constrains a value to not exceed a maximum and minimum value. All
|
|
args are cast to ints."
|
|
[amt low high]
|
|
(PApplet/constrain (int amt) (int low) (int high))))
|
|
|
|
|
|
(defn
|
|
^{:requires-bindings false
|
|
:processing-name "constrain()"
|
|
:category "Math"
|
|
:subcategory "Calculation"
|
|
:added "1.0"}
|
|
constrain
|
|
"Constrains a value to not exceed a maximum and minimum value."
|
|
[amt low high]
|
|
#?(:clj
|
|
(if (u/int-like? amt)
|
|
(constrain-int amt low high)
|
|
(constrain-float amt low high))
|
|
:cljs (.constrain (ap/current-applet) amt low high)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "copy()"
|
|
:category "Image"
|
|
:subcategory "Pixels"
|
|
:added "1.0"}
|
|
copy
|
|
"Copies a region of pixels from the one image to another. If src-img
|
|
is not specified it defaults to current-graphics. If dest-img is not
|
|
specified - it defaults to current-graphics. If the source
|
|
and destination regions aren't the same size, it will automatically
|
|
resize the source pixels to fit the specified target region. No
|
|
alpha information is used in the process, however if the source
|
|
image has an alpha channel set, it will be copied as well. "
|
|
([[sx sy swidth sheight] [dx dy dwidth dheight]]
|
|
(.copy (current-graphics)
|
|
(int sx) (int sy) (int swidth) (int sheight)
|
|
(int dx) (int dy) (int dwidth) (int dheight)))
|
|
|
|
([^PImage src-img [sx sy swidth sheight] [dx dy dwidth dheight]]
|
|
(copy src-img (current-graphics) [sx sy swidth sheight] [dx dy dwidth dheight]))
|
|
|
|
([^PImage src-img ^PImage dest-img [sx sy swidth sheight] [dx dy dwidth dheight]]
|
|
(.copy dest-img src-img (int sx) (int sy) (int swidth) (int sheight)
|
|
(int dx) (int dy) (int dwidth) (int dheight))))
|
|
|
|
(defn
|
|
^{:requires-bindings false
|
|
:processing-name "cos()"
|
|
:category "Math"
|
|
:subcategory "Trigonometry"
|
|
:added "1.0"}
|
|
cos
|
|
"Calculates the cosine of an angle. This function expects the values
|
|
of the angle parameter to be provided in radians (values from 0 to
|
|
Math/PI*2). Values are returned in the range -1 to 1."
|
|
[angle]
|
|
#?(:clj (PApplet/cos (float angle))
|
|
:cljs (.cos (ap/current-applet) angle)))
|
|
|
|
#?(:clj
|
|
(defn
|
|
^{:requires-bindings false
|
|
:processing-name nil
|
|
:category "Typography"
|
|
:subcategory "Loading & Displaying"
|
|
:added "1.0"}
|
|
font-available?
|
|
"Returns true if font (specified as a string) is available on this
|
|
system, false otherwise"
|
|
[font-str]
|
|
(if (some #{font-str} (available-fonts))
|
|
true
|
|
false)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "createFont()"
|
|
:category "Typography"
|
|
:subcategory "Loading & Displaying"
|
|
:added "1.0"}
|
|
create-font
|
|
"Dynamically converts a font to the format used by Processing (a
|
|
PFont) from either a font name that's installed on the computer, or
|
|
from a .ttf or .otf file inside the sketches 'data' folder. This
|
|
function is an advanced feature for precise control.
|
|
|
|
Use available-fonts to obtain the names for the fonts recognized by
|
|
the computer and are compatible with this function.
|
|
|
|
The size parameter states the font size you want to generate. The
|
|
smooth parameter specifies if the font should be antialiased or not,
|
|
and the charset parameter is an array of chars that specifies the
|
|
characters to generate.
|
|
|
|
This function creates a bitmapped version of a font It loads a font
|
|
by name, and converts it to a series of images based on the size of
|
|
the font. When possible, the text function will use a native font
|
|
rather than the bitmapped version created behind the scenes with
|
|
create-font. For instance, when using the default renderer
|
|
setting (JAVA2D), the actual native version of the font will be
|
|
employed by the sketch, improving drawing quality and
|
|
performance. With the :p2d, :p3d, and :opengl renderer settings, the
|
|
bitmapped version will be used. While this can drastically improve
|
|
speed and appearance, results are poor when exporting if the sketch
|
|
does not include the .otf or .ttf file, and the requested font is
|
|
not available on the machine running the sketch."
|
|
([name size] (.createFont (ap/current-applet) (str name) (float size)))
|
|
([name size smooth] (.createFont (ap/current-applet) (str name) (float size) smooth))
|
|
([name size smooth ^chars charset]
|
|
(.createFont (ap/current-applet) (str name) (float size) smooth charset)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "createGraphics()"
|
|
:category "Image"
|
|
:subcategory "Rendering"
|
|
:added "1.0"}
|
|
create-graphics
|
|
"Creates and returns a new PGraphics object of the types :p2d, :p3d,
|
|
:java2d, :pdf. By default :java2d is used. Use this class if you
|
|
need to draw into an off-screen graphics buffer. It's not possible
|
|
to use create-graphics with the :opengl renderer, because it doesn't
|
|
allow offscreen use. The :pdf renderer requires the filename parameter.
|
|
|
|
Note: don't use create-graphics in draw in clojurescript, it leaks memory.
|
|
You should create graphic in setup and reuse it in draw instead of creating
|
|
a new one.
|
|
|
|
It's important to call any drawing commands between (.beginDraw graphics) and
|
|
(.endDraw graphics) statements or use with-graphics macro. This is also true
|
|
for any commands that affect drawing, such as smooth or color-mode.
|
|
|
|
If you're using :pdf renderer - don't forget to call (.dispose graphics)
|
|
as last command inside with-graphics macro, otherwise graphics won't be
|
|
saved.
|
|
|
|
Unlike the main drawing surface which is completely opaque, surfaces
|
|
created with create-graphics can have transparency. This makes it
|
|
possible to draw into a graphics and maintain the alpha channel. By
|
|
using save to write a PNG or TGA file, the transparency of the
|
|
graphics object will be honored."
|
|
([w h]
|
|
(.createGraphics (ap/current-applet) (int w) (int h) #?(:cljs :p2d)))
|
|
([w h renderer]
|
|
(.createGraphics (ap/current-applet) (int w) (int h) (ap/resolve-renderer renderer)))
|
|
([w h renderer path]
|
|
(.createGraphics (ap/current-applet) (int w) (int h) (ap/resolve-renderer renderer)
|
|
#?(:clj (u/absolute-path path)
|
|
:cljs path))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "createImage()"
|
|
:category "Image"
|
|
:subcategory nil
|
|
:added "1.0"}
|
|
create-image
|
|
"Creates a new PImage (the datatype for storing images). This
|
|
provides a fresh buffer of pixels to play with. Set the size of the
|
|
buffer with the width and height parameters. The format parameter
|
|
defines how the pixels are stored. See the PImage reference for more
|
|
information.
|
|
|
|
Possible formats: :rgb, :argb, :alpha (grayscale alpha channel)
|
|
|
|
Prefer using create-image over initialising new PImage instances
|
|
directly."
|
|
[w h format]
|
|
(let [format (u/resolve-constant-key format image-formats)]
|
|
(.createImage (ap/current-applet) (int w) (int h) (int format))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "PGraphics.fillColor"
|
|
:processing-link "http://processing.github.io/processing-javadocs/core/processing/core/PGraphics.html#fillColor"
|
|
:category "Color"
|
|
:subcategory "Creating & Reading"}
|
|
current-fill
|
|
"Return the current fill color."
|
|
[]
|
|
(.-fillColor (current-graphics)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "PGraphics.strokeColor"
|
|
:processing-link "http://processing.github.io/processing-javadocs/core/processing/core/PGraphics.html#strokeColor"
|
|
:category "Color"
|
|
:subcategory "Creating & Reading"}
|
|
current-stroke
|
|
"Return the current stroke color."
|
|
[]
|
|
(.-strokeColor (current-graphics)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "cursor()"
|
|
:category "Environment"
|
|
:subcategory nil
|
|
:added "1.0"}
|
|
cursor
|
|
"Sets the cursor to a predefined symbol or makes it
|
|
visible if already hidden (after no-cursor was called).
|
|
|
|
Available modes: :arrow, :cross, :hand, :move, :text, :wait
|
|
|
|
See cursor-image for specifying a generic image as the cursor
|
|
symbol."
|
|
([] (.cursor (ap/current-applet)))
|
|
([cursor-mode]
|
|
(let [cursor-mode (u/resolve-constant-key cursor-mode cursor-modes)]
|
|
(.cursor (ap/current-applet)
|
|
#?(:clj (int cursor-mode)
|
|
:cljs (str cursor-mode))))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "cursor()"
|
|
:category "Environment"
|
|
:subcategory nil
|
|
:added "1.0"}
|
|
cursor-image
|
|
"Set the cursor to a predefined image. The horizontal and vertical
|
|
active spots of the cursor may be specified with hx and hy.
|
|
It is recommended to make the size 16x16 or 32x32 pixels."
|
|
([^PImage img] (.cursor (ap/current-applet) img))
|
|
([^PImage img hx hy] (.cursor (ap/current-applet) img (int hx) (int hy))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "curve()"
|
|
:category "Shape"
|
|
:subcategory "Curves"
|
|
:added "1.0"}
|
|
curve
|
|
"Draws a curved line on the screen. The first and second parameters
|
|
specify the beginning control point and the last two parameters
|
|
specify the ending control point. The middle parameters specify the
|
|
start and stop of the curve. Longer curves can be created by putting
|
|
a series of curve fns together or using curve-vertex. An additional
|
|
fn called curve-tightness provides control for the visual quality of
|
|
the curve. The curve fn is an implementation of Catmull-Rom
|
|
splines."
|
|
([x1 y1 x2 y2 x3 y3 x4 y4]
|
|
(.curve (current-graphics)
|
|
(float x1) (float y1)
|
|
(float x2) (float y2)
|
|
(float x3) (float y3)
|
|
(float x4) (float y4)))
|
|
([x1 y1 z1 x2 y2 z2 x3 y3 z3 x4 y4 z4]
|
|
(.curve (current-graphics)
|
|
(float x1) (float y1) (float z1)
|
|
(float x2) (float y2) (float z2)
|
|
(float x3) (float y3) (float z3)
|
|
(float x4) (float y4) (float z4))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "curveDetail()"
|
|
:category "Shape"
|
|
:subcategory "Curves"
|
|
:added "1.0"}
|
|
curve-detail
|
|
"Sets the resolution at which curves display. The default value is
|
|
20. This function is only useful when using the :p3d or :opengl
|
|
renderer as the default (:java2d) renderer does not use this
|
|
information."
|
|
[detail]
|
|
(.curveDetail (current-graphics) (int detail)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "curvePoint()"
|
|
:category "Shape"
|
|
:subcategory "Curves"
|
|
:added "1.0"}
|
|
curve-point
|
|
"Evalutes the curve at point t for points a, b, c, d. The parameter
|
|
t varies between 0 and 1, a and d are points on the curve, and b c
|
|
and are the control points. This can be done once with the x
|
|
coordinates and a second time with the y coordinates to get the
|
|
location of a curve at t."
|
|
[a b c d t]
|
|
(.curvePoint (current-graphics) (float a) (float b) (float c) (float d) (float t)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "curveTangent()"
|
|
:category "Shape"
|
|
:subcategory "Curves"
|
|
:added "1.0"}
|
|
curve-tangent
|
|
"Calculates the tangent of a point on a curve.
|
|
See: http://en.wikipedia.org/wiki/Tangent"
|
|
[a b c d t]
|
|
(.curveTangent (current-graphics) (float a) (float b) (float c) (float d) (float t)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "curveTightness()"
|
|
:category "Shape"
|
|
:subcategory "Curves"
|
|
:added "1.0"}
|
|
curve-tightness
|
|
"Modifies the quality of forms created with curve and
|
|
curve-vertex. The parameter squishy determines how the curve fits
|
|
to the vertex points. The value 0.0 is the default value for
|
|
squishy (this value defines the curves to be Catmull-Rom splines)
|
|
and the value 1.0 connects all the points with straight
|
|
lines. Values within the range -5.0 and 5.0 will deform the curves
|
|
but will leave them recognizable and as values increase in
|
|
magnitude, they will continue to deform."
|
|
[ti]
|
|
(.curveTightness (current-graphics) (float ti)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "curveVertex()"
|
|
:category "Shape"
|
|
:subcategory "Vertex"
|
|
:added "1.0"}
|
|
curve-vertex
|
|
"Specifies vertex coordinates for curves. This function may only be
|
|
used between begin-shape and end-shape and only when there is no
|
|
mode keyword specified to begin-shape. The first and last points in a
|
|
series of curve-vertex lines will be used to guide the beginning and
|
|
end of a the curve. A minimum of four points is required to draw a
|
|
tiny curve between the second and third points. Adding a fifth point
|
|
with curve-vertex will draw the curve between the second, third, and
|
|
fourth points. The curve-vertex function is an implementation of
|
|
Catmull-Rom splines."
|
|
([x y] (.curveVertex (current-graphics) (float x) (float y)))
|
|
([x y z] (.curveVertex (current-graphics) (float x) (float y) (float z))))
|
|
|
|
(defn
|
|
^{:requires-bindings false
|
|
:processing-name "day()"
|
|
:category "Input"
|
|
:subcategory "Time & Date"
|
|
:added "1.0"}
|
|
day
|
|
"Get the current day of the month (1 through 31)."
|
|
[]
|
|
#?(:clj (PApplet/day)
|
|
:cljs (.day (ap/current-applet))))
|
|
|
|
(defn
|
|
^{:requires-bindings false
|
|
:processing-name "degrees()"
|
|
:category "Math"
|
|
:subcategory "Trigonometry"
|
|
:added "1.0"}
|
|
degrees
|
|
"Converts a radian measurement to its corresponding value in
|
|
degrees. Radians and degrees are two ways of measuring the same
|
|
thing. There are 360 degrees in a circle and (* 2 Math/PI) radians
|
|
in a circle. For example, (= 90° (/ Math/PI 2) 1.5707964). All
|
|
trigonometric methods in Processing require their parameters to be
|
|
specified in radians."
|
|
[radians]
|
|
#?(:clj (PApplet/degrees (float radians))
|
|
:cljs (.degrees (ap/current-applet) radians)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "delay()"
|
|
:processing-link nil
|
|
:category "Structure"
|
|
:subcategory nil
|
|
:added "1.0"}
|
|
delay-frame
|
|
"Forces the program to stop running for a specified time. Delay
|
|
times are specified in thousandths of a second, therefore the
|
|
function call (delay 3000) will stop the program for three
|
|
seconds. Because the screen is updated only at the end of draw,
|
|
the program may appear to 'freeze', because the screen will not
|
|
update when the delay fn is used. This function has no affect
|
|
inside setup."
|
|
[freeze-ms]
|
|
(.delay (ap/current-applet) (int freeze-ms)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "directionalLight()"
|
|
:category "Lights, Camera"
|
|
:subcategory "Lights"
|
|
:added "1.0"}
|
|
directional-light
|
|
"Adds a directional light. Directional light comes from one
|
|
direction and is stronger when hitting a surface squarely and weaker
|
|
if it hits at a gentle angle. After hitting a surface, a
|
|
directional lights scatters in all directions. Lights need to be
|
|
included in the draw fn to remain persistent in a looping
|
|
program. Placing them in the setup fn of a looping program will cause
|
|
them to only have an effect the first time through the loop. The
|
|
affect of the r, g, and b parameters is determined by the current
|
|
color mode. The nx, ny, and nz parameters specify the direction the
|
|
light is facing. For example, setting ny to -1 will cause the
|
|
geometry to be lit from below (the light is facing directly upward)"
|
|
[r g b nx ny nz]
|
|
(.directionalLight (current-graphics) (float r) (float g) (float b)
|
|
(float nx) (float ny) (float nz)))
|
|
|
|
(defn
|
|
^{:requires-bindings false
|
|
:processing-name "dist()"
|
|
:category "Math"
|
|
:subcategory "Calculation"
|
|
:added "1.0"}
|
|
dist
|
|
"Calculates the distance between two points"
|
|
([x1 y1 x2 y2]
|
|
#?(:clj (PApplet/dist (float x1) (float y1) (float x2) (float y2))
|
|
:cljs (.dist (ap/current-applet) x1 y1 x2 y2)))
|
|
([x1 y1 z1 x2 y2 z2]
|
|
#?(:clj (PApplet/dist (float x1) (float y1) (float z1) (float x2) (float y2) (float z2))
|
|
:cljs (.dist (ap/current-applet) x1 y1 z1 x2 y2 z2))))
|
|
|
|
(defmacro
|
|
^{:requires-bindings true
|
|
:processing-name nil
|
|
:category "Output"
|
|
:subcategory "Files"
|
|
:added "2.5"}
|
|
do-record
|
|
"Macro for drawing on graphics which saves result in the file at the end.
|
|
Similar to 'with-graphics' macro. do-record assumed to be used with :pdf
|
|
graphics. Example:
|
|
|
|
(q/do-record (q/create-graphics 200 200 :pdf \"output.pdf\")
|
|
(q/fill 250 0 0)
|
|
(q/ellipse 100 100 150 150))
|
|
"
|
|
[graphics & body]
|
|
`(let [gr# ~graphics]
|
|
(with-graphics gr#
|
|
~@body)
|
|
(.dispose gr#)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "ellipse()"
|
|
:category "Shape"
|
|
:subcategory "2D Primitives"
|
|
:added "1.0"}
|
|
ellipse
|
|
"Draws an ellipse (oval) in the display window. An ellipse with an
|
|
equal width and height is a circle. The origin may be changed with
|
|
the ellipse-mode function"
|
|
[x y width height]
|
|
(.ellipse (current-graphics) (float x) (float y) (float width) (float height)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "ellipseMode()"
|
|
:category "Shape"
|
|
:subcategory "Attributes"
|
|
:added "1.0"}
|
|
ellipse-mode
|
|
"Modifies the origin of the ellispse according to the specified mode:
|
|
|
|
:center - specifies the location of the ellipse as
|
|
the center of the shape. (Default).
|
|
:radius - similar to center, but the width and height parameters to
|
|
ellipse specify the radius of the ellipse, rather than the
|
|
diameter.
|
|
:corner - draws the shape from the upper-left corner of its bounding
|
|
box.
|
|
:corners - uses the four parameters to ellipse to set two opposing
|
|
corners of the ellipse's bounding box."
|
|
[mode]
|
|
(let [mode (u/resolve-constant-key mode ellipse-modes)]
|
|
(.ellipseMode (current-graphics) (int mode))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "emissive()"
|
|
:category "Lights, Camera"
|
|
:subcategory "Material Properties"
|
|
:added "1.0"}
|
|
emissive-float
|
|
"Sets the emissive color of the material used for drawing shapes
|
|
drawn to the screen. Used in combination with ambient, specular, and
|
|
shininess in setting the material properties of shapes. Converts all
|
|
args to floats"
|
|
([float-val] (.emissive (current-graphics) (float float-val)))
|
|
([r g b] (.emissive (current-graphics) (float r) (float g) (float b))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "emissive()"
|
|
:category "Lights, Camera"
|
|
:subcategory "Material Properties"
|
|
:added "1.0"}
|
|
emissive-int
|
|
"Sets the emissive color of the material used for drawing shapes
|
|
drawn to the screen. Used in combination with ambient, specular, and
|
|
shininess in setting the material properties of shapes. Converts all
|
|
args to ints"
|
|
[int-val] (.emissive (current-graphics) (int int-val)))
|
|
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "emissive()"
|
|
:category "Lights, Camera"
|
|
:subcategory "Material Properties"
|
|
:added "1.0"}
|
|
emissive
|
|
"Sets the emissive color of the material used for drawing shapes
|
|
drawn to the screen. Used in combination with ambient, specular, and
|
|
shininess in setting the material properties of shapes.
|
|
|
|
If passed one arg - it is assumed to be an int (i.e. a color),
|
|
multiple args are converted to floats."
|
|
([c]
|
|
#?(:clj (if (u/int-like? c) (emissive-int c) (emissive-float c))
|
|
:cljs (emissive-float c)))
|
|
([r g b] (emissive-float r g b)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "endCamera()"
|
|
:category "Lights, Camera"
|
|
:subcategory "Camera"
|
|
:added "1.0"}
|
|
end-camera
|
|
"Unsets the matrix mode from the camera matrix. See begin-camera."
|
|
[]
|
|
(.endCamera (current-graphics)))
|
|
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "endContour()"
|
|
:category "Shape"
|
|
:subcategory "Vertex"
|
|
:added "2.0"}
|
|
end-contour
|
|
"Use the begin-contour and end-contour function to create negative
|
|
shapes within shapes. These functions can only be within a
|
|
begin-shape/end-shape pair and they only work with the :p2d and :p3d
|
|
renderers."
|
|
[]
|
|
(.endContour (current-graphics)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "endRaw()"
|
|
:category "Output"
|
|
:subcategory "Files"
|
|
:added "1.0"}
|
|
end-raw
|
|
"Complement to begin-raw; they must always be used together. See
|
|
the begin-raw docstring for details."
|
|
[]
|
|
(.endRaw (current-graphics)))
|
|
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "endShape()"
|
|
:category "Shape"
|
|
:subcategory "Vertex"
|
|
:added "1.0"}
|
|
end-shape
|
|
"May only be called after begin-shape. When end-shape is called,
|
|
all of image data defined since the previous call to begin-shape is
|
|
written into the image buffer. The keyword :close may be passed to
|
|
close the shape (to connect the beginning and the end)."
|
|
([] (.endShape (current-graphics)))
|
|
([mode]
|
|
(when-not (= :close mode)
|
|
#?(:clj (throw (Exception. (str "Unknown mode value: " mode ". Expected :close")))
|
|
:cljs nil))
|
|
(.endShape (current-graphics)
|
|
#?(:clj PApplet/CLOSE
|
|
:cljs 2))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "exit()"
|
|
:category "Structure"
|
|
:subcategory nil
|
|
:added "1.0"}
|
|
exit
|
|
"Quits/stops/exits the program. Rather than terminating
|
|
immediately, exit will cause the sketch to exit after draw has
|
|
completed (or after setup completes if called during the setup
|
|
method). "
|
|
[]
|
|
(.exit (ap/current-applet)))
|
|
|
|
(defn
|
|
^{:requires-bindings false
|
|
:processing-name "exp()"
|
|
:category "Math"
|
|
:subcategory "Calculation"
|
|
:added "1.0"}
|
|
exp
|
|
"Returns Euler's number e (2.71828...) raised to the power of the
|
|
value parameter."
|
|
[val]
|
|
#?(:clj (PApplet/exp (float val))
|
|
:cljs (.exp (ap/current-applet) val)))
|
|
|
|
#?(:cljs
|
|
(defn- clear-no-fill-cljs
|
|
"Sets custom property on graphcs object indicating that it has
|
|
fill color."
|
|
[graphics]
|
|
(aset graphics no-fill-prop false)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "fill()"
|
|
:category "Color"
|
|
:subcategory "Setting"
|
|
:added "1.0"}
|
|
fill-float
|
|
"Sets the color used to fill shapes. For example, (fill 204 102 0),
|
|
will specify that all subsequent shapes will be filled with orange."
|
|
([gray]
|
|
(.fill (current-graphics) (float gray))
|
|
#?(:cljs (clear-no-fill-cljs (current-graphics))))
|
|
([gray alpha]
|
|
(.fill (current-graphics) (float gray) (float alpha))
|
|
#?(:cljs (clear-no-fill-cljs (current-graphics))))
|
|
([r g b]
|
|
(.fill (current-graphics) (float r) (float g) (float b))
|
|
#?(:cljs (clear-no-fill-cljs (current-graphics))))
|
|
([r g b alpha]
|
|
(.fill (current-graphics) (float r) (float g) (float b) (float alpha))
|
|
#?(:cljs (clear-no-fill-cljs (current-graphics)))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "fill()"
|
|
:category "Color"
|
|
:subcategory "Setting"
|
|
:added "1.0"}
|
|
fill-int
|
|
"Sets the color used to fill shapes."
|
|
([rgb]
|
|
(.fill (current-graphics) (unchecked-int rgb))
|
|
#?(:cljs (clear-no-fill-cljs (current-graphics))))
|
|
([rgb alpha]
|
|
(.fill (current-graphics) (unchecked-int rgb) (float alpha))
|
|
#?(:cljs (clear-no-fill-cljs (current-graphics)))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "fill()"
|
|
:category "Color"
|
|
:subcategory "Setting"
|
|
:added "1.0"}
|
|
fill
|
|
"Sets the color used to fill shapes."
|
|
([rgb]
|
|
#?(:clj (if (u/int-like? rgb) (fill-int rgb) (fill-float rgb))
|
|
:cljs (fill-float rgb)))
|
|
|
|
([rgb alpha]
|
|
#?(:clj (if (u/int-like? rgb) (fill-int rgb alpha) (fill-float rgb alpha))
|
|
:cljs (fill-float rgb alpha)))
|
|
|
|
([r g b] (fill-float r g b))
|
|
([r g b a] (fill-float r g b a)))
|
|
|
|
#?(:clj
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "displayDensity()"
|
|
:category "Environment"
|
|
:subcategory nil
|
|
:added "2.4.0"}
|
|
display-density
|
|
"This function returns the number 2 if the screen is a high-density
|
|
screen (called a Retina display on OS X or high-dpi on Windows and
|
|
Linux) and a 1 if not. This information is useful for a program to
|
|
adapt to run at double the pixel density on a screen that supports
|
|
it. Can be used in conjunction with (pixel-density)"
|
|
([] (.displayDensity (ap/current-applet)))
|
|
([display] (PApplet/displayDensity display))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "filter()"
|
|
:category "Image"
|
|
:subcategory "Pixels"
|
|
:added "1.0"}
|
|
display-filter
|
|
"Originally named filter in Processing Language.
|
|
Filters the display window with the specified mode and level.
|
|
Level defines the quality of the filter and mode may be one of the
|
|
following keywords:
|
|
|
|
:threshold - converts the image to black and white pixels depending
|
|
if they are above or below the threshold defined by
|
|
the level parameter. The level must be between
|
|
0.0 (black) and 1.0 (white). If no level is specified,
|
|
0.5 is used.
|
|
:gray - converts any colors in the image to grayscale
|
|
equivalents. Doesn't work with level.
|
|
:invert - sets each pixel to its inverse value. Doesn't work with
|
|
level.
|
|
:posterize - limits each channel of the image to the number of
|
|
colors specified as the level parameter. The parameter can
|
|
be set to values between 2 and 255, but results are most
|
|
noticeable in the lower ranges.
|
|
:blur - executes a Guassian blur with the level parameter
|
|
specifying the extent of the blurring. If no level
|
|
parameter is used, the blur is equivalent to Guassian
|
|
blur of radius 1.
|
|
:opaque - sets the alpha channel to entirely opaque. Doesn't work
|
|
with level.
|
|
:erode - reduces the light areas. Doesn't work with level.
|
|
:dilate - increases the light areas. Doesn't work with level."
|
|
([mode]
|
|
(.filter (current-graphics)
|
|
(int (u/resolve-constant-key mode filter-modes))))
|
|
|
|
([mode level]
|
|
(let [mode (u/resolve-constant-key mode filter-modes)]
|
|
(.filter (current-graphics) (int mode) (float level)))))
|
|
|
|
#?(:clj
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "filter()"
|
|
:category "Image"
|
|
:subcategory "Pixels"
|
|
:added "2.0"}
|
|
filter-shader
|
|
"Originally named filter in Processing Language.
|
|
Filters the display window with given shader (only in :p2d and :p3d modes)."
|
|
[^PShader shader-obj] (.filter (current-graphics) shader-obj)))
|
|
|
|
(defn
|
|
^{:requires-bindings false
|
|
:processing-name "floor()"
|
|
:category "Math"
|
|
:subcategory "Calculation"
|
|
:added "2.0"}
|
|
floor
|
|
"Calculates the closest int value that is less than or equal to the
|
|
value of the parameter. For example, (floor 9.03) returns the value 9."
|
|
[n]
|
|
#?(:clj (PApplet/floor (float n))
|
|
:cljs (.floor (ap/current-applet) n)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "focused"
|
|
:category "Environment"
|
|
:subcategory nil
|
|
:added "1.0"}
|
|
focused
|
|
"Returns a boolean value representing whether the applet has focus."
|
|
[] (.-focused (ap/current-applet)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "frameCount"
|
|
:category "Environment"
|
|
:subcategory nil
|
|
:added "1.0"}
|
|
frame-count
|
|
"The system variable frameCount contains the number of frames
|
|
displayed since the program started. Inside setup() the value is 0
|
|
and after the first iteration of draw it is 1, etc."
|
|
[]
|
|
#?(:clj (.frameCount (ap/current-applet))
|
|
:cljs (.-frameCount (ap/current-applet))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "frameRate"
|
|
:category "Environment"
|
|
:subcategory nil
|
|
:added "1.0"}
|
|
current-frame-rate
|
|
"Returns the current framerate"
|
|
[]
|
|
#?(:clj (.frameRate (ap/current-applet))
|
|
:cljs (.-__frameRate (ap/current-applet))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "frameRate()"
|
|
:category "Environment"
|
|
:subcategory nil
|
|
:added "1.0"}
|
|
frame-rate
|
|
"Specifies a new target framerate (number of frames to be displayed every
|
|
second). If the processor is not fast enough to maintain the
|
|
specified rate, it will not be achieved. For example, the function
|
|
call (frame-rate 30) will attempt to refresh 30 times a second. It
|
|
is recommended to set the frame rate within setup. The default rate
|
|
is 60 frames per second."
|
|
[new-rate]
|
|
(do
|
|
#?(:cljs (reset! (.-target-frame-rate (ap/current-applet)) new-rate))
|
|
(.frameRate (ap/current-applet) (float new-rate))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "frustum()"
|
|
:category "Lights, Camera"
|
|
:subcategory "Camera"
|
|
:added "1.0"}
|
|
frustum
|
|
"Sets a perspective matrix defined through the parameters. Works
|
|
like glFrustum, except it wipes out the current perspective matrix
|
|
rather than muliplying itself with it."
|
|
[left right bottom top near far]
|
|
(.frustum (current-graphics) (float left) (float right) (float bottom) (float top)
|
|
(float near) (float far)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "get()"
|
|
:category "Image"
|
|
:subcategory "Pixels"
|
|
:added "1.0"}
|
|
get-pixel
|
|
"Reads the color of any pixel or grabs a section of an image. If no
|
|
parameters are specified, a copy of entire image is returned. Get the
|
|
value of one pixel by specifying an x,y coordinate. Get a section of
|
|
the image by specifying an additional width and height parameter.
|
|
If the pixel requested is outside of the image window, black is returned.
|
|
The numbers returned are scaled according to the current color ranges,
|
|
but only RGB values are returned by this function. For example, even though
|
|
you may have drawn a shape with (color-mode :hsb), the numbers returned
|
|
will be in RGB.
|
|
|
|
Getting the color of a single pixel with (get x y) is easy, but not
|
|
as fast as grabbing the data directly using the pixels fn.
|
|
|
|
If no img specified - current-graphics is used."
|
|
([] (get-pixel (current-graphics)))
|
|
([^PImage img] (.get img))
|
|
([x y] (get-pixel (current-graphics) x y))
|
|
([^PImage img x y] (.get img (int x) (int y)))
|
|
([x y w h] (get-pixel (current-graphics) x y w h))
|
|
([^PImage img x y w h] (.get img (int x) (int y) (int w) (int h))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "green()"
|
|
:category "Color"
|
|
:subcategory "Creating & Reading"
|
|
:added "1.0"}
|
|
green
|
|
"Extracts the green value from a color, scaled to match current
|
|
color-mode. This value is always returned as a float so be careful
|
|
not to assign it to an int value."
|
|
[col]
|
|
(.green (current-graphics) (unchecked-int col)))
|
|
|
|
(defn
|
|
^{:require-binding false
|
|
:processing-name "hex()"
|
|
:category "Data"
|
|
:subcategory "Conversion"}
|
|
hex
|
|
"Converts a byte, char, int, or color to a String containing the
|
|
equivalent hexadecimal notation. For example color(0, 102, 153) will
|
|
convert to the String \"FF006699\". This function can help make your
|
|
geeky debugging sessions much happier. "
|
|
([val]
|
|
#?(:clj (PApplet/hex (int val))
|
|
:cljs (.hex (ap/current-applet) val)))
|
|
([val num-digits]
|
|
#?(:clj (PApplet/hex (int val) (int num-digits))
|
|
:cljs (.hex (ap/current-applet) val num-digits))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "getHeight()"
|
|
:processing-link nil
|
|
:category "Environment"
|
|
:subcategory nil
|
|
:added "1.0"}
|
|
height
|
|
"Height of the display window. The value of height is zero until
|
|
size is called."
|
|
[]
|
|
(.-height (ap/current-applet)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "hint()"
|
|
:processing-link nil
|
|
:category "Rendering"
|
|
:subcategory nil
|
|
:added "1.0"}
|
|
hint
|
|
"Set various hints and hacks for the renderer. This is used to
|
|
handle obscure rendering features that cannot be implemented in a
|
|
consistent manner across renderers. Many options will often graduate
|
|
to standard features instead of hints over time.
|
|
|
|
Options:
|
|
|
|
:enable-native-fonts - Use the native version fonts when they are
|
|
installed, rather than the bitmapped version from a .vlw
|
|
file. This is useful with the default (or JAVA2D) renderer
|
|
setting, as it will improve font rendering speed. This is not
|
|
enabled by default, because it can be misleading while testing
|
|
because the type will look great on your machine (because you have
|
|
the font installed) but lousy on others' machines if the identical
|
|
font is unavailable. This option can only be set per-sketch, and
|
|
must be called before any use of text-font.
|
|
|
|
:disable-native-fonts - Disables native font support.
|
|
|
|
:disable-depth-test - Disable the zbuffer, allowing you to draw on
|
|
top of everything at will. When depth testing is disabled, items
|
|
will be drawn to the screen sequentially, like a painting. This
|
|
hint is most often used to draw in 3D, then draw in 2D on top of
|
|
it (for instance, to draw GUI controls in 2D on top of a 3D
|
|
interface). Starting in release 0149, this will also clear the
|
|
depth buffer. Restore the default with :enable-depth-test
|
|
but note that with the depth buffer cleared, any 3D drawing that
|
|
happens later in draw will ignore existing shapes on the screen.
|
|
|
|
:enable-depth-test - Enables the zbuffer.
|
|
|
|
:enable-depth-sort - Enable primitive z-sorting of triangles and
|
|
lines in :p3d and :opengl rendering modes. This can slow
|
|
performance considerably, and the algorithm is not yet perfect.
|
|
|
|
:disable-depth-sort - Disables hint :enable-depth-sort
|
|
|
|
:disable-opengl-errors - Speeds up the OPENGL renderer setting
|
|
by not checking for errors while running.
|
|
|
|
:enable-opengl-errors - Turns on OpenGL error checking
|
|
|
|
:enable-depth-mask
|
|
:disable-depth-mask
|
|
|
|
:enable-optimized-stroke
|
|
:disable-optimized-stroke
|
|
:enable-retina-pixels
|
|
:disable-retina-pixels
|
|
:enable-stroke-perspective
|
|
:disable-stroke-perspective
|
|
:enable-stroke-pure
|
|
:disable-stroke-pure
|
|
:enable-texture-mipmaps
|
|
:disable-texture-mipmaps
|
|
"
|
|
[hint-type]
|
|
(let [hint-type (if (keyword? hint-type)
|
|
(get hint-options hint-type)
|
|
hint-type)]
|
|
(.hint (current-graphics) (int hint-type))))
|
|
|
|
(defn
|
|
^{:requires-bindings false
|
|
:processing-name "hour()"
|
|
:category "Input"
|
|
:subcategory "Time & Date"
|
|
:added "1.0"}
|
|
hour
|
|
"Returns the current hour as a value from 0 - 23."
|
|
[]
|
|
#?(:clj (PApplet/hour)
|
|
:cljs (.hour (ap/current-applet))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "hue()"
|
|
:category "Color"
|
|
:subcategory "Creating & Reading"
|
|
:added "1.0"}
|
|
hue
|
|
"Extracts the hue value from a color."
|
|
[col]
|
|
(.hue (current-graphics) (unchecked-int col)))
|
|
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "image()"
|
|
:category "Image"
|
|
:subcategory "Loading & Displaying"
|
|
:added "1.0"}
|
|
image
|
|
"Displays images to the screen. Processing currently works with GIF,
|
|
JPEG, and Targa images. The color of an image may be modified with
|
|
the tint function and if a GIF has transparency, it will maintain
|
|
its transparency. The img parameter specifies the image to display
|
|
and the x and y parameters define the location of the image from its
|
|
upper-left corner. The image is displayed at its original size
|
|
unless the width and height parameters specify a different size. The
|
|
image-mode fn changes the way the parameters work. A call to
|
|
(image-mode :corners) will change the width and height parameters to
|
|
define the x and y values of the opposite corner of the image.
|
|
|
|
Starting with release 0124, when using the default (JAVA2D)
|
|
renderer, smooth will also improve image quality of resized
|
|
images."
|
|
(#?(:clj [^PImage img x y]
|
|
:cljs [img x y])
|
|
(.image (current-graphics) img (float x) (float y)))
|
|
|
|
(#?(:clj [^PImage img x y c d]
|
|
:cljs [img x y c d])
|
|
(.image (current-graphics) img (float x) (float y) (float c) (float d))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "PImage.filter()"
|
|
:category "Image"
|
|
:subcategory "Pixels"
|
|
:added "2.0"}
|
|
image-filter
|
|
"Originally named filter in Processing Language.
|
|
Filters given image with the specified mode and level.
|
|
Level defines the quality of the filter and mode may be one of
|
|
the following keywords:
|
|
|
|
:threshold - converts the image to black and white pixels depending
|
|
if they are above or below the threshold defined by
|
|
the level parameter. The level must be between
|
|
0.0 (black) and 1.0 (white). If no level is specified,
|
|
0.5 is used.
|
|
:gray - converts any colors in the image to grayscale
|
|
equivalents. Doesn't work with level.
|
|
:invert - sets each pixel to its inverse value. Doesn't work with
|
|
level.
|
|
:posterize - limits each channel of the image to the number of
|
|
colors specified as the level parameter. The parameter can
|
|
be set to values between 2 and 255, but results are most
|
|
noticeable in the lower ranges.
|
|
:blur - executes a Guassian blur with the level parameter
|
|
specifying the extent of the blurring. If no level
|
|
parameter is used, the blur is equivalent to Guassian
|
|
blur of radius 1.
|
|
:opaque - sets the alpha channel to entirely opaque. Doesn't work
|
|
with level.
|
|
:erode - reduces the light areas. Doesn't work with level.
|
|
:dilate - increases the light areas. Doesn't work with level."
|
|
([^PImage img mode]
|
|
(let [mode (u/resolve-constant-key mode filter-modes)]
|
|
(.filter img (int mode))))
|
|
([^PImage img mode level]
|
|
(let [mode (u/resolve-constant-key mode filter-modes)]
|
|
(.filter img (int mode) (float level)))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "imageMode()"
|
|
:category "Image"
|
|
:subcategory "Loading & Displaying"
|
|
:added "1.0"}
|
|
image-mode
|
|
"Modifies the location from which images draw. The default mode is :corner.
|
|
Available modes are:
|
|
|
|
:corner - specifies the location to be the upper left corner and
|
|
uses the fourth and fifth parameters of image to set the
|
|
image's width and height.
|
|
|
|
:corners - uses the second and third parameters of image to set the
|
|
location of one corner of the image and uses the fourth
|
|
and fifth parameters to set the opposite corner.
|
|
|
|
:center - draw images centered at the given x and y position."
|
|
[mode]
|
|
(let [mode (u/resolve-constant-key mode image-modes)]
|
|
(.imageMode (current-graphics) (int mode))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "keyCode"
|
|
:category "Input"
|
|
:subcategory "Keyboard"
|
|
:added "1.0"}
|
|
key-code
|
|
"The variable keyCode is used to detect special keys such as the UP,
|
|
DOWN, LEFT, RIGHT arrow keys and ALT, CONTROL, SHIFT. When checking
|
|
for these keys, it's first necessary to check and see if the key is
|
|
coded. This is done with the conditional (= (key) CODED).
|
|
|
|
The keys included in the ASCII specification (BACKSPACE, TAB, ENTER,
|
|
RETURN, ESC, and DELETE) do not require checking to see if they key
|
|
is coded, and you should simply use the key variable instead of
|
|
key-code If you're making cross-platform projects, note that the
|
|
ENTER key is commonly used on PCs and Unix and the RETURN key is
|
|
used instead on Macintosh. Check for both ENTER and RETURN to make
|
|
sure your program will work for all platforms.
|
|
|
|
For users familiar with Java, the values for UP and DOWN are simply
|
|
shorter versions of Java's KeyEvent.VK_UP and
|
|
KeyEvent.VK_DOWN. Other keyCode values can be found in the Java
|
|
KeyEvent reference."
|
|
[]
|
|
(.-keyCode (ap/current-applet)))
|
|
|
|
#?(:clj
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name nil
|
|
:category "Input"
|
|
:subcategory "Keyboard"
|
|
:added "2.4.0"}
|
|
key-modifiers
|
|
"Set of key modifiers that were pressed when event happened.
|
|
Possible modifiers :ctrl, :alt, :shift, :meta. Not available in
|
|
ClojureScript."
|
|
[]
|
|
(let [modifiers
|
|
(if-let [^processing.event.Event
|
|
event (-> (ap/current-applet) meta :key-event deref)]
|
|
[(if (.isAltDown event) :alt nil)
|
|
(if (.isShiftDown event) :shift nil)
|
|
(if (.isControlDown event) :control nil)
|
|
(if (.isMetaDown event) :meta nil)]
|
|
[])]
|
|
(set (remove nil? modifiers)))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "keyPressed"
|
|
:category "Input"
|
|
:subcategory "Keyboard"
|
|
:added "1.0"}
|
|
key-pressed?
|
|
"true if any key is currently pressed, false otherwise."
|
|
[]
|
|
#?(:clj (.-keyPressed (ap/current-applet))
|
|
:cljs (.-__keyPressed (ap/current-applet))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "lightFalloff()"
|
|
:category "Lights, Camera"
|
|
:subcategory "Lights"
|
|
:added "1.0"}
|
|
light-falloff
|
|
"Sets the falloff rates for point lights, spot lights, and ambient
|
|
lights. The parameters are used to determine the falloff with the
|
|
following equation:
|
|
|
|
d = distance from light position to vertex position
|
|
falloff = 1 / (CONSTANT + d * LINEAR + (d*d) * QUADRATIC)
|
|
|
|
Like fill, it affects only the elements which are created after it
|
|
in the code. The default value is (light-falloff 1.0 0.0 0.0).
|
|
Thinking about an ambient light with a falloff can be tricky. It is
|
|
used, for example, if you wanted a region of your scene to be lit
|
|
ambiently one color and another region to be lit ambiently by
|
|
another color, you would use an ambient light with location and
|
|
falloff. You can think of it as a point light that doesn't care
|
|
which direction a surface is facing."
|
|
[constant linear quadratic]
|
|
(.lightFalloff (current-graphics) (float constant) (float linear) (float quadratic)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "lerpColor()"
|
|
:category "Color"
|
|
:subcategory "Creating & Reading"
|
|
:added "1.0"}
|
|
lerp-color
|
|
"Calculates a color or colors between two color at a specific
|
|
increment. The amt parameter is the amount to interpolate between
|
|
the two values where 0.0 equal to the first point, 0.1 is very near
|
|
the first point, 0.5 is half-way in between, etc."
|
|
[c1 c2 amt]
|
|
(.lerpColor (current-graphics) (unchecked-int c1) (unchecked-int c2) (float amt)))
|
|
|
|
(defn
|
|
^{:requires-bindings false
|
|
:processing-name "lerp()"
|
|
:category "Math"
|
|
:subcategory "Calculation"
|
|
:added "1.0"}
|
|
lerp
|
|
"Calculates a number between two numbers at a specific
|
|
increment. The amt parameter is the amount to interpolate between
|
|
the two values where 0.0 equal to the first point, 0.1 is very near
|
|
the first point, 0.5 is half-way in between, etc. The lerp function
|
|
is convenient for creating motion along a straight path and for
|
|
drawing dotted lines."
|
|
[start stop amt]
|
|
#?(:clj (PApplet/lerp (float start) (float stop) (float amt))
|
|
:cljs (.lerp (ap/current-applet) start stop amt)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "lights()"
|
|
:category "Lights, Camera"
|
|
:subcategory "Lights"
|
|
:added "1.0"}
|
|
lights
|
|
"Sets the default ambient light, directional light, falloff, and
|
|
specular values. The defaults are:
|
|
|
|
(ambient-light 128 128 128)
|
|
(directional-light 128 128 128 0 0 -1)
|
|
(light-falloff 1 0 0)
|
|
(light-specular 0 0 0).
|
|
|
|
Lights need to be included in the draw to remain persistent in a
|
|
looping program. Placing them in the setup of a looping program
|
|
will cause them to only have an effect the first time through the
|
|
loop."
|
|
[]
|
|
(.lights (current-graphics)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "lightSpecular()"
|
|
:category "Lights, Camera"
|
|
:subcategory "Lights"
|
|
:added "1.0"}
|
|
light-specular
|
|
"Sets the specular color for lights. Like fill, it affects only the
|
|
elements which are created after it in the code. Specular refers to
|
|
light which bounces off a surface in a perferred direction (rather
|
|
than bouncing in all directions like a diffuse light) and is used
|
|
for creating highlights. The specular quality of a light interacts
|
|
with the specular material qualities set through the specular and
|
|
shininess functions."
|
|
[r g b]
|
|
(.lightSpecular (current-graphics) (float r) (float g) (float b)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "line()"
|
|
:category "Shape"
|
|
:subcategory "2D Primitives"
|
|
:added "1.0"}
|
|
line
|
|
"Draws a line (a direct path between two points) to the screen. The
|
|
version of line with four parameters draws the line in 2D. To color
|
|
a line, use the stroke function. A line cannot be filled, therefore
|
|
the fill method will not affect the color of a line. 2D lines are
|
|
drawn with a width of one pixel by default, but this can be changed
|
|
with the stroke-weight function. The version with six parameters
|
|
allows the line to be placed anywhere within XYZ space. "
|
|
([p1 p2] (apply line (concat p1 p2)))
|
|
([x1 y1 x2 y2] (.line (current-graphics) (float x1) (float y1) (float x2) (float y2)))
|
|
([x1 y1 z1 x2 y2 z2]
|
|
(.line (current-graphics) (float x1) (float y1) (float z1)
|
|
(float x2) (float y2) (float z2))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "loadFont()"
|
|
:category "Typography"
|
|
:subcategory "Loading & Displaying"
|
|
:added "1.0"}
|
|
load-font
|
|
"Loads a font into a variable of type PFont. To load correctly,
|
|
fonts must be located in the data directory of the current sketch.
|
|
To create a font to use with Processing use the create-font fn.
|
|
|
|
Like load-image and other methods that load data, the load-font fn
|
|
should not be used inside draw, because it will slow down the sketch
|
|
considerably, as the font will be re-loaded from the disk (or
|
|
network) on each frame.
|
|
|
|
For most renderers, Processing displays fonts using the .vlw font
|
|
format, which uses images for each letter, rather than defining them
|
|
through vector data. When hint :enable-native-fonts is used with the
|
|
JAVA2D renderer, the native version of a font will be used if it is
|
|
installed on the user's machine.
|
|
|
|
Using create-font (instead of load-font) enables vector data to be
|
|
used with the JAVA2D (default) renderer setting. This can be helpful
|
|
when many font sizes are needed, or when using any renderer based on
|
|
JAVA2D, such as the PDF library."
|
|
[filename]
|
|
(.loadFont (ap/current-applet) (str filename)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "loadImage()"
|
|
:category "Image"
|
|
:subcategory "Loading & Displaying"
|
|
:added "1.0"}
|
|
load-image
|
|
"Loads an image into a variable of type PImage. Four types of
|
|
images ( .gif, .jpg, .tga, .png) images may be loaded. To load
|
|
correctly, images must be located in the data directory of the
|
|
current sketch. In most cases, load all images in setup to preload
|
|
them at the start of the program. Loading images inside draw will
|
|
reduce the speed of a program.
|
|
|
|
The filename parameter can also be a URL to a file found online.
|
|
|
|
If an image is not loaded successfully, the null value is returned
|
|
and an error message will be printed to the console. The error
|
|
message does not halt the program, however the null value may cause
|
|
a NullPointerException if your code does not check whether the value
|
|
returned from load-image is nil.
|
|
|
|
Depending on the type of error, a PImage object may still be
|
|
returned, but the width and height of the image will be set to
|
|
-1. This happens if bad image data is returned or cannot be decoded
|
|
properly. Sometimes this happens with image URLs that produce a 403
|
|
error or that redirect to a password prompt, because load-image
|
|
will attempt to interpret the HTML as image data."
|
|
[filename]
|
|
(.loadImage (ap/current-applet) (str filename)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "loadShader()"
|
|
:category "Rendering"
|
|
:subcategory "Shaders"
|
|
:added "2.0"}
|
|
load-shader
|
|
"Loads a shader into the PShader object. Shaders are compatible with the
|
|
P2D and P3D renderers, but not with the default renderer."
|
|
([fragment-filename]
|
|
(.loadShader (current-graphics) fragment-filename))
|
|
([fragment-filename vertex-filename]
|
|
(.loadShader (current-graphics) fragment-filename vertex-filename)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "loadShape()"
|
|
:category "Shape"
|
|
:subcategory "Loading & Displaying"
|
|
:added "1.0"}
|
|
load-shape
|
|
"Load a geometry from a file as a PShape."
|
|
[filename]
|
|
(.loadShape (ap/current-applet) filename))
|
|
|
|
(defn
|
|
^{:requires-bindings false
|
|
:processing-name "log()"
|
|
:category "Math"
|
|
:subcategory "Calculation"
|
|
:added "1.0"}
|
|
log
|
|
"Calculates the natural logarithm (the base-e logarithm) of a
|
|
number. This function expects the values greater than 0.0."
|
|
[val]
|
|
#?(:clj (PApplet/log (float val))
|
|
:cljs (.log (ap/current-applet) val)))
|
|
|
|
(defn
|
|
^{:requires-bindings false
|
|
:processing-name "mag()"
|
|
:category "Math"
|
|
:subcategory "Calculation"
|
|
:added "1.0"}
|
|
mag
|
|
"Calculates the magnitude (or length) of a vector. A vector is a
|
|
direction in space commonly used in computer graphics and linear
|
|
algebra. Because it has no start position, the magnitude of a vector
|
|
can be thought of as the distance from coordinate (0,0) to its (x,y)
|
|
value. Therefore, mag is a shortcut for writing (dist 0 0 x y)."
|
|
([a b]
|
|
#?(:clj (PApplet/mag (float a) (float b))
|
|
:cljs (.mag (ap/current-applet) a b)))
|
|
([a b c]
|
|
#?(:clj (PApplet/mag (float a) (float b) (float c))
|
|
:cljs (.mag (ap/current-applet) a b c))))
|
|
|
|
(defn
|
|
^{:requires-bindings false
|
|
:processing-name "map()"
|
|
:category "Math"
|
|
:subcategory "Calculation"
|
|
:added "1.0"}
|
|
map-range
|
|
"Re-maps a number from one range to another.
|
|
|
|
Numbers outside the range are not clamped to 0 and 1, because
|
|
out-of-range values are often intentional and useful."
|
|
[val low1 high1 low2 high2]
|
|
#?(:clj (PApplet/map (float val) (float low1) (float high1) (float low2) (float high2))
|
|
:cljs (.map (ap/current-applet) val low1 high1 low2 high2)))
|
|
|
|
#?(:clj
|
|
(defn
|
|
^{:requires-bindings false
|
|
:processing-name "PImage.mask()"
|
|
:category "Image"
|
|
:subcategory "Loading & Displaying"
|
|
:added "1.0"}
|
|
mask-image
|
|
"Masks part of an image from displaying by loading another image and
|
|
using it as an alpha channel. This mask image should only contain
|
|
grayscale data, but only the blue color channel is used. The mask
|
|
image needs to be the same size as the image to which it is
|
|
applied.
|
|
|
|
If single argument function is used - masked image is sketch itself
|
|
or graphics if used inside with-graphics macro. If you're passing
|
|
graphics to this function - it works only with :p3d and :opengl renderers.
|
|
|
|
This method is useful for creating dynamically generated alpha
|
|
masks."
|
|
([^PImage mask] (mask-image (current-graphics) mask))
|
|
([^PImage img ^PImage mask] (.mask img mask))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "millis()"
|
|
:category "Input"
|
|
:subcategory "Time & Date"
|
|
:added "1.0"}
|
|
millis
|
|
"Returns the number of milliseconds (thousandths of a second) since
|
|
starting the sketch. This information is often used for timing
|
|
animation sequences."
|
|
[]
|
|
(.millis (ap/current-applet)))
|
|
|
|
(defn
|
|
^{:requires-bindings false
|
|
:processing-name "minute()"
|
|
:category "Input"
|
|
:subcategory "Time & Date"
|
|
:added "1.0"}
|
|
minute
|
|
"Returns the current minute as a value from 0 - 59"
|
|
[]
|
|
#?(:clj (PApplet/minute)
|
|
:cljs (.minute (ap/current-applet))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "modelX()"
|
|
:category "Lights, Camera"
|
|
:subcategory "Coordinates"
|
|
:added "1.0"}
|
|
model-x
|
|
"Returns the three-dimensional x, y, z position in model space. This
|
|
returns the x value for a given coordinate based on the current set
|
|
of transformations (scale, rotate, translate, etc.) The x value can
|
|
be used to place an object in space relative to the location of the
|
|
original point once the transformations are no longer in use."
|
|
[x y z]
|
|
(.modelX (current-graphics) (float x) (float y) (float z)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "modelY()"
|
|
:category "Lights, Camera"
|
|
:subcategory "Coordinates"
|
|
:added "1.0"}
|
|
model-y
|
|
"Returns the three-dimensional x, y, z position in model space. This
|
|
returns the y value for a given coordinate based on the current set
|
|
of transformations (scale, rotate, translate, etc.) The y value can
|
|
be used to place an object in space relative to the location of the
|
|
original point once the transformations are no longer in use."
|
|
[x y z]
|
|
(.modelY (current-graphics) (float x) (float y) (float z)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "modelZ()"
|
|
:category "Lights, Camera"
|
|
:subcategory "Coordinates"
|
|
:added "1.0"}
|
|
model-z
|
|
"Returns the three-dimensional x, y, z position in model space. This
|
|
returns the z value for a given coordinate based on the current set
|
|
of transformations (scale, rotate, translate, etc.) The z value can
|
|
be used to place an object in space relative to the location of the
|
|
original point once the transformations are no longer in use."
|
|
[x y z]
|
|
(.modelZ (current-graphics) (float x) (float y) (float z)))
|
|
|
|
(defn
|
|
^{:requires-bindings false
|
|
:processing-name "month()"
|
|
:category "Input"
|
|
:subcategory "Time & Date"
|
|
:added "1.0"}
|
|
month
|
|
"Returns the current month as a value from 1 - 12."
|
|
[]
|
|
#?(:clj (PApplet/month)
|
|
:cljs (.month (ap/current-applet))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "mouseButton"
|
|
:category "Input"
|
|
:subcategory "Mouse"
|
|
:added "1.0"}
|
|
mouse-button
|
|
"The value of the system variable mouseButton is either :left, :right,
|
|
or :center depending on which button is pressed. nil if no button pressed"
|
|
[]
|
|
(let [button-code (.-mouseButton (ap/current-applet))]
|
|
#?(:clj
|
|
(condp = button-code
|
|
PConstants/LEFT :left
|
|
PConstants/RIGHT :right
|
|
PConstants/CENTER :center
|
|
nil)
|
|
|
|
:cljs
|
|
(condp = button-code
|
|
37 :left
|
|
39 :right
|
|
3 :center
|
|
nil))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "mousePressed"
|
|
:category "Input"
|
|
:subcategory "Mouse"
|
|
:added "1.0"}
|
|
mouse-pressed?
|
|
"Variable storing if a mouse button is pressed. The value of the
|
|
system variable mousePressed is true if a mouse button is pressed
|
|
and false if a button is not pressed."
|
|
[]
|
|
#?(:clj (.-mousePressed (ap/current-applet))
|
|
:cljs (.-__mousePressed (ap/current-applet))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "mouseX"
|
|
:category "Input"
|
|
:subcategory "Mouse"
|
|
:added "1.0"}
|
|
mouse-x
|
|
"Current horizontal coordinate of the mouse."
|
|
[]
|
|
(.-mouseX (ap/current-applet)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "mouseY"
|
|
:category "Input"
|
|
:subcategory "Mouse"
|
|
:added "1.0"}
|
|
mouse-y
|
|
"Current vertical coordinate of the mouse."
|
|
[]
|
|
(.-mouseY (ap/current-applet)))
|
|
|
|
#?(:clj
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "noClip()"
|
|
:category "Rendering"
|
|
:subcategory nil
|
|
:added "2.4.0"}
|
|
no-clip
|
|
"Disables the clipping previously started by the clip() function."
|
|
[]
|
|
(.noClip (current-graphics))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "noCursor()"
|
|
:category "Environment"
|
|
:subcategory nil
|
|
:added "1.0"}
|
|
no-cursor
|
|
"Hides the cursor from view. Will not work when running the in full
|
|
screen (Present) mode."
|
|
[]
|
|
(.noCursor (ap/current-applet)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "noFill()"
|
|
:category "Color"
|
|
:subcategory "Setting"
|
|
:added "1.0"}
|
|
no-fill
|
|
"Disables filling geometry. If both no-stroke and no-fill are called,
|
|
nothing will be drawn to the screen." []
|
|
(.noFill (current-graphics))
|
|
#?(:cljs (aset (current-graphics) no-fill-prop true)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "random2d()"
|
|
:category "Math"
|
|
:subcategory "Random"
|
|
:added "2.6"}
|
|
random-2d
|
|
"Returns a new 2D unit vector in a random direction" []
|
|
(let [theta (.random (ap/current-applet) TWO-PI)]
|
|
[(Math/cos theta) (Math/sin theta)]))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "random3d()"
|
|
:category "Math"
|
|
:subcategory "Random"
|
|
:added "2.6"}
|
|
random-3d
|
|
"Returns a new 3D unit vector in a random direction" []
|
|
(let [theta (.random (ap/current-applet) TWO-PI)
|
|
phi (.random (ap/current-applet) (- HALF-PI) HALF-PI)
|
|
vx (* (Math/cos theta) (Math/sin phi))
|
|
vy (* (Math/sin theta) (Math/sin phi))
|
|
vz (Math/cos phi)]
|
|
[vx vy vz]))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "noise()"
|
|
:category "Math"
|
|
:subcategory "Random"
|
|
:added "1.0"}
|
|
noise
|
|
"Returns the Perlin noise value at specified coordinates. Perlin
|
|
noise is a random sequence generator producing a more natural
|
|
ordered, harmonic succession of numbers compared to the standard
|
|
random function. It was invented by Ken Perlin in the 1980s and
|
|
been used since in graphical applications to produce procedural
|
|
textures, natural motion, shapes, terrains etc.
|
|
|
|
The main difference to the random function is that Perlin noise is
|
|
defined in an infinite n-dimensional space where each pair of
|
|
coordinates corresponds to a fixed semi-random value (fixed only for
|
|
the lifespan of the program). The resulting value will always be
|
|
between 0.0 and 1.0. Processing can compute 1D, 2D and 3D noise,
|
|
depending on the number of coordinates given. The noise value can be
|
|
animated by moving through the noise space and the 2nd and 3rd
|
|
dimensions can also be interpreted as time.
|
|
|
|
The actual noise is structured similar to an audio signal, in
|
|
respect to the function's use of frequencies. Similar to the concept
|
|
of harmonics in physics, perlin noise is computed over several
|
|
octaves which are added together for the final result.
|
|
|
|
Another way to adjust the character of the resulting sequence is the
|
|
scale of the input coordinates. As the function works within an
|
|
infinite space the value of the coordinates doesn't matter as such,
|
|
only the distance between successive coordinates does (eg. when
|
|
using noise within a loop). As a general rule the smaller the
|
|
difference between coordinates, the smoother the resulting noise
|
|
sequence will be. Steps of 0.005-0.03 work best for most
|
|
applications, but this will differ depending on use."
|
|
([x] (.noise (ap/current-applet) (float x)))
|
|
([x y] (.noise (ap/current-applet) (float x) (float y)))
|
|
([x y z] (.noise (ap/current-applet) (float x) (float y) (float z))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "noiseDetail()"
|
|
:category "Math"
|
|
:subcategory "Random"
|
|
:added "1.0"}
|
|
noise-detail
|
|
"Adjusts the character and level of detail produced by the Perlin
|
|
noise function. Similar to harmonics in physics, noise is computed
|
|
over several octaves. Lower octaves contribute more to the output
|
|
signal and as such define the overal intensity of the noise, whereas
|
|
higher octaves create finer grained details in the noise
|
|
sequence. By default, noise is computed over 4 octaves with each
|
|
octave contributing exactly half than its predecessor, starting at
|
|
50% strength for the 1st octave. This falloff amount can be changed
|
|
by adding an additional function parameter. Eg. a falloff factor of
|
|
0.75 means each octave will now have 75% impact (25% less) of the
|
|
previous lower octave. Any value between 0.0 and 1.0 is valid,
|
|
however note that values greater than 0.5 might result in greater
|
|
than 1.0 values returned by noise.
|
|
|
|
By changing these parameters, the signal created by the noise
|
|
function can be adapted to fit very specific needs and
|
|
characteristics."
|
|
([octaves] (.noiseDetail (ap/current-applet) (int octaves)))
|
|
([octaves falloff] (.noiseDetail (ap/current-applet) (int octaves) (float falloff))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "noiseSeed()"
|
|
:category "Math"
|
|
:subcategory "Random"
|
|
:added "1.0"}
|
|
noise-seed
|
|
"Sets the seed value for noise. By default, noise produces different
|
|
results each time the program is run. Set the value parameter to a
|
|
constant to return the same pseudo-random numbers each time the
|
|
software is run."
|
|
[val]
|
|
(.noiseSeed (ap/current-applet) (int val)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "noLights()"
|
|
:category "Lights, Camera"
|
|
:subcategory "Lights"
|
|
:added "1.0"}
|
|
no-lights
|
|
"Disable all lighting. Lighting is turned off by default and enabled
|
|
with the lights fn. This function can be used to disable lighting so
|
|
that 2D geometry (which does not require lighting) can be drawn
|
|
after a set of lighted 3D geometry."
|
|
[]
|
|
(.noLights (current-graphics)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "noLoop()"
|
|
:category "Structure"
|
|
:subcategory nil
|
|
:added "1.0"}
|
|
no-loop
|
|
"Stops Processing from continuously executing the code within
|
|
draw. If start-loop is called, the code in draw will begin to run
|
|
continuously again. If using no-loop in setup, it should be the last
|
|
line inside the block.
|
|
|
|
When no-loop is used, it's not possible to manipulate or access the
|
|
screen inside event handling functions such as mouse-pressed or
|
|
key-pressed. Instead, use those functions to call redraw or
|
|
loop which will run draw, which can update the screen
|
|
properly. This means that when no-loop has been called, no drawing
|
|
can happen, and functions like save-frame may not be used.
|
|
|
|
Note that if the sketch is resized, redraw will be called to
|
|
update the sketch, even after no-oop has been
|
|
specified. Otherwise, the sketch would enter an odd state until
|
|
loop was called."
|
|
[]
|
|
(.noLoop (ap/current-applet)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "norm()"
|
|
:category "Math"
|
|
:subcategory "Calculation"
|
|
:added "1.0"}
|
|
norm
|
|
"Normalize a value to exist between 0 and 1 (inclusive)."
|
|
[val start stop]
|
|
#?(:clj (PApplet/norm (float val) (float start) (float stop))
|
|
:cljs (.norm (ap/current-applet) val start stop)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "normal()"
|
|
:category "Lights, Camera"
|
|
:subcategory "Lights"
|
|
:added "1.0"}
|
|
normal
|
|
"Sets the current normal vector. This is for drawing three
|
|
dimensional shapes and surfaces and specifies a vector perpendicular
|
|
to the surface of the shape which determines how lighting affects
|
|
it. Processing attempts to automatically assign normals to shapes,
|
|
but since that's imperfect, this is a better option when you want
|
|
more control. This function is identical to glNormal3f() in OpenGL."
|
|
[nx ny nz]
|
|
(.normal (current-graphics) (float nx) (float ny) (float nz)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "noSmooth()"
|
|
:category "Shape"
|
|
:subcategory "Attributes"
|
|
:added "1.0"}
|
|
no-smooth
|
|
"Draws all geometry with jagged (aliased) edges. Must be called inside
|
|
:settings handler."
|
|
[] (.noSmooth (current-graphics)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "noStroke()"
|
|
:category "Color"
|
|
:subcategory "Setting"
|
|
:added "1.0"}
|
|
no-stroke
|
|
"Disables drawing the stroke (outline). If both no-stroke and
|
|
no-fill are called, nothing will be drawn to the screen."
|
|
[]
|
|
(.noStroke (current-graphics)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "noTint()"
|
|
:category "Image"
|
|
:subcategory "Loading & Displaying"
|
|
:added "1.0"}
|
|
no-tint
|
|
"Removes the current fill value for displaying images and reverts to
|
|
displaying images with their original hues."
|
|
[]
|
|
(.noTint (current-graphics)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "ortho()"
|
|
:category "Lights, Camera"
|
|
:subcategory "Camera"
|
|
:added "1.0"}
|
|
ortho
|
|
"Sets an orthographic projection and defines a parallel clipping
|
|
volume. All objects with the same dimension appear the same size,
|
|
regardless of whether they are near or far from the camera. The
|
|
parameters to this function specify the clipping volume where left
|
|
and right are the minimum and maximum x values, top and bottom are
|
|
the minimum and maximum y values, and near and far are the minimum
|
|
and maximum z values. If no parameters are given, the default is
|
|
used: (ortho 0 width 0 height -10 10)"
|
|
([] (.ortho (current-graphics)))
|
|
([left right bottom top]
|
|
(.ortho (current-graphics) (float left) (float right) (float bottom) (float top)))
|
|
([left right bottom top near far]
|
|
(.ortho (current-graphics) (float left) (float right) (float bottom) (float top) (float near) (float far))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "perspective()"
|
|
:category "Lights, Camera"
|
|
:subcategory "Camera"
|
|
:added "1.0"}
|
|
perspective
|
|
"Sets a perspective projection applying foreshortening, making
|
|
distant objects appear smaller than closer ones. The parameters
|
|
define a viewing volume with the shape of truncated pyramid. Objects
|
|
near to the front of the volume appear their actual size, while
|
|
farther objects appear smaller. This projection simulates the
|
|
perspective of the world more accurately than orthographic
|
|
projection. The version of perspective without parameters sets the
|
|
default perspective and the version with four parameters allows the
|
|
programmer to set the area precisely. The default values are:
|
|
perspective(PI/3.0, width/height, cameraZ/10.0, cameraZ*10.0) where
|
|
cameraZ is ((height/2.0) / tan(PI*60.0/360.0));"
|
|
([] (.perspective (current-graphics)))
|
|
([fovy aspect z-near z-far]
|
|
(.perspective (current-graphics) (float fovy) (float aspect)
|
|
(float z-near) (float z-far))))
|
|
|
|
#?(:clj
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "pixelDensity()"
|
|
:category "Environment"
|
|
:subcategory nil
|
|
:added "2.4.0"}
|
|
pixel-density
|
|
"It makes it possible for Processing to render using all of the pixels
|
|
on high resolutions screens like Apple Retina displays and Windows
|
|
High-DPI displays. Possible values 1 or 2. Must be called only from
|
|
:settings handler. To get density of the current screen you can use
|
|
(display-density) function."
|
|
[density]
|
|
(.pixelDensity (ap/current-applet) density)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "pixels[]"
|
|
:category "Image"
|
|
:subcategory "Pixels"
|
|
:added "1.0"}
|
|
pixels
|
|
"Array containing the values for all the pixels in the display
|
|
window or image. This array is therefore the size of the display window. If
|
|
this array is modified, the update-pixels fn must be called to update
|
|
the changes. Calls .loadPixels before obtaining the pixel array."
|
|
([] (pixels (current-graphics)))
|
|
|
|
#?(:clj
|
|
([^PImage img]
|
|
(.loadPixels img)
|
|
(.-pixels img))
|
|
|
|
:cljs
|
|
([img]
|
|
(.loadPixels img)
|
|
(let [pix-array (.toArray (.-pixels img))]
|
|
(set! (.-stored-pix-array img) pix-array)
|
|
pix-array))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "pmouseX"
|
|
:category "Input"
|
|
:subcategory "Mouse"
|
|
:added "1.0"}
|
|
pmouse-x
|
|
"Horizontal coordinate of the mouse in the previous frame"
|
|
[]
|
|
(.-pmouseX (ap/current-applet)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "pmouseY"
|
|
:category "Input"
|
|
:subcategory "Mouse"
|
|
:added "1.0"}
|
|
pmouse-y
|
|
"Vertical coordinate of the mouse in the previous frame"
|
|
[]
|
|
(.-pmouseY (ap/current-applet)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "point()"
|
|
:category "Shape"
|
|
:subcategory "2D Primitives"
|
|
:added "1.0"}
|
|
point
|
|
"Draws a point, a coordinate in space at the dimension of one
|
|
pixel. The first parameter is the horizontal value for the point,
|
|
the second value is the vertical value for the point, and the
|
|
optional third value is the depth value. Drawing this shape in 3D
|
|
using the z parameter requires the :P3D or :opengl renderer to be
|
|
used."
|
|
([x y] (.point (current-graphics) (float x)(float y)))
|
|
([x y z] (.point (current-graphics) (float x) (float y) (float z))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "pointLight()"
|
|
:category "Lights, Camera"
|
|
:subcategory "Lights"
|
|
:added "1.0"}
|
|
point-light
|
|
"Adds a point light. Lights need to be included in the draw() to
|
|
remain persistent in a looping program. Placing them in the setup()
|
|
of a looping program will cause them to only have an effect the
|
|
first time through the loop. The affect of the r, g, and b
|
|
parameters is determined by the current color mode. The x, y, and z
|
|
parameters set the position of the light"
|
|
[r g b x y z]
|
|
(.pointLight (current-graphics) (float r) (float g) (float b) (float x) (float y) (float z)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "popMatrix()"
|
|
:category "Transform"
|
|
:subcategory nil
|
|
:added "1.0"}
|
|
pop-matrix
|
|
"Pops the current transformation matrix off the matrix
|
|
stack. Understanding pushing and popping requires understanding the
|
|
concept of a matrix stack. The push-matrix fn saves the current
|
|
coordinate system to the stack and pop-matrix restores the prior
|
|
coordinate system. push-matrix and pop-matrix are used in conjuction
|
|
with the other transformation methods and may be embedded to control
|
|
the scope of the transformations."
|
|
[]
|
|
(.popMatrix (current-graphics)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "popStyle()"
|
|
:category "Structure"
|
|
:subcategory nil
|
|
:added "1.0"}
|
|
pop-style
|
|
"Restores the prior settings on the 'style stack'. Used in
|
|
conjunction with push-style. Together they allow you to change the
|
|
style settings and later return to what you had. When a new style is
|
|
started with push-style, it builds on the current style information.
|
|
The push-style and pop-style functions can be nested to provide more
|
|
control"
|
|
[]
|
|
(.popStyle (current-graphics)))
|
|
|
|
(defn
|
|
^{:requires-bindings false
|
|
:processing-name "pow()"
|
|
:category "Math"
|
|
:subcategory "Calculation"
|
|
:added "1.0"}
|
|
pow
|
|
"Facilitates exponential expressions. The pow() function is an
|
|
efficient way of multiplying numbers by themselves (or their
|
|
reciprocal) in large quantities. For example, (pow 3 5) is
|
|
equivalent to the expression (* 3 3 3 3 3) and (pow 3 -5) is
|
|
equivalent to (/ 1 (* 3 3 3 3 3))."
|
|
[num exponent]
|
|
#?(:clj (PApplet/pow (float num) (float exponent))
|
|
:cljs (.pow (ap/current-applet) num exponent)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "printCamera()"
|
|
:category "Lights, Camera"
|
|
:subcategory "Camera"
|
|
:added "1.0"}
|
|
print-camera
|
|
"Prints the current camera matrix to std out. Useful for debugging."
|
|
[]
|
|
(.printCamera (current-graphics)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "printMatrix()"
|
|
:category "Transform"
|
|
:subcategory nil
|
|
:added "1.0"}
|
|
print-matrix
|
|
"Prints the current matrix to std out. Useful for debugging."
|
|
[]
|
|
(.printMatrix (current-graphics)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "printProjection()"
|
|
:category "Lights, Camera"
|
|
:subcategory "Camera"
|
|
:added "1.0"}
|
|
print-projection
|
|
"Prints the current projection matrix to std out. Useful for
|
|
debugging"
|
|
[]
|
|
(.printProjection (current-graphics)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "pushMatrix()"
|
|
:category "Transform"
|
|
:subcategory nil
|
|
:added "1.0"}
|
|
push-matrix
|
|
"Pushes the current transformation matrix onto the matrix
|
|
stack. Understanding push-matrix and pop-matrix requires
|
|
understanding the concept of a matrix stack. The push-matrix
|
|
function saves the current coordinate system to the stack and
|
|
pop-matrix restores the prior coordinate system. push-matrix and
|
|
pop-matrix are used in conjuction with the other transformation
|
|
methods and may be embedded to control the scope of the
|
|
transformations."
|
|
[]
|
|
(.pushMatrix (current-graphics)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "pushStyle()"
|
|
:category "Structure"
|
|
:subcategory nil
|
|
:added "1.0"}
|
|
push-style
|
|
"Saves the current style settings onto a 'style stack'. Use with
|
|
pop-style which restores the prior settings. Note that these
|
|
functions are always used together. They allow you to change the
|
|
style settings and later return to what you had. When a new style is
|
|
started with push-style, it builds on the current style
|
|
information. The push-style and pop-style fns can be embedded to
|
|
provide more control.
|
|
|
|
The style information controlled by the following functions are
|
|
included in the style: fill, stroke, tint, stroke-weight,
|
|
stroke-cap, stroke-join, image-mode, rect-mode, ellipse-mode,
|
|
shape-mode, color-mode, text-align, text-font, text-mode, text-size,
|
|
text-leading, emissive, specular, shininess, and ambient"
|
|
[]
|
|
(.pushStyle (current-graphics)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "quad()"
|
|
:category "Shape"
|
|
:subcategory "2D Primitives"
|
|
:added "1.0"}
|
|
quad
|
|
"A quad is a quadrilateral, a four sided polygon. It is similar to a
|
|
rectangle, but the angles between its edges are not constrained to
|
|
be ninety degrees. The first pair of parameters (x1,y1) sets the
|
|
first vertex and the subsequent pairs should proceed clockwise or
|
|
counter-clockwise around the defined shape."
|
|
[x1 y1 x2 y2 x3 y3 x4 y4]
|
|
(.quad (current-graphics)
|
|
(float x1) (float y1)
|
|
(float x2) (float y2)
|
|
(float x3) (float y3)
|
|
(float x4) (float y4)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "quadraticVertex()"
|
|
:category "Shape"
|
|
:subcategory "Vertex"
|
|
:added "2.0"}
|
|
quadratic-vertex
|
|
"Specifies vertex coordinates for quadratic Bezier curves. Each call to
|
|
quadratic-vertex defines the position of one control points and one
|
|
anchor point of a Bezier curve, adding a new segment to a line or shape.
|
|
The first time quadratic-vertex is used within a begin-shape call, it
|
|
must be prefaced with a call to vertex to set the first anchor point.
|
|
This function must be used between begin-shape and end-shape and only
|
|
when there is no MODE parameter specified to begin-shape. Using the 3D
|
|
version requires rendering with :p3d."
|
|
([cx cy x3 y3]
|
|
(.quadraticVertex (current-graphics) (float cx) (float cy) (float x3) (float y3)))
|
|
([cx cy cz x3 y3 z3]
|
|
(.quadraticVertex (current-graphics) (float cx) (float cy) (float cz) (float x3) (float y3) (float z3))))
|
|
|
|
(defn
|
|
^{:requires-bindings false
|
|
:processing-name "radians()"
|
|
:category "Math"
|
|
:subcategory "Trigonometry"
|
|
:added "1.0"}
|
|
radians
|
|
"Converts a degree measurement to its corresponding value in
|
|
radians. Radians and degrees are two ways of measuring the same
|
|
thing. There are 360 degrees in a circle and 2*PI radians in a
|
|
circle. For example, 90° = PI/2 = 1.5707964. All trigonometric
|
|
methods in Processing require their parameters to be specified in
|
|
radians."
|
|
[degrees]
|
|
#?(:clj (PApplet/radians (float degrees))
|
|
:cljs (.radians (ap/current-applet) degrees)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "random()"
|
|
:category "Math"
|
|
:subcategory "Random"
|
|
:added "1.0"}
|
|
random
|
|
"Generates random numbers. Each time the random function is called,
|
|
it returns an unexpected value within the specified range. If one
|
|
parameter is passed to the function it will return a float between
|
|
zero and the value of the high parameter. The function call (random
|
|
5) returns values between 0 and 5 (starting at zero, up to but not
|
|
including 5). If two parameters are passed, it will return a float
|
|
with a value between the parameters. The function call
|
|
(random -5 10.2) returns values starting at -5 up to (but not
|
|
including) 10.2."
|
|
([max] (.random (ap/current-applet) (float max)))
|
|
([min max] (.random (ap/current-applet) (float min) (float max))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "randomGaussian()"
|
|
:category "Math"
|
|
:subcategory "Random"
|
|
:added "2.0"}
|
|
random-gaussian
|
|
"Returns a float from a random series of numbers having a mean of 0 and
|
|
standard deviation of 1. Each time the randomGaussian() function is called,
|
|
it returns a number fitting a Gaussian, or normal, distribution.
|
|
There is theoretically no minimum or maximum value that randomGaussian()
|
|
might return. Rather, there is just a very low probability that values far
|
|
from the mean will be returned; and a higher probability that numbers near
|
|
the mean will be returned. ."
|
|
[]
|
|
(.randomGaussian (ap/current-applet)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "randomSeed()"
|
|
:category "Math"
|
|
:subcategory "Random"
|
|
:added "1.0"}
|
|
random-seed
|
|
"Sets the seed value for random. By default, random produces
|
|
different results each time the program is run. Set the value
|
|
parameter to a constant to return the same pseudo-random numbers
|
|
each time the software is run."
|
|
[w]
|
|
(.randomSeed (ap/current-applet) (float w)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "key"
|
|
:category "Input"
|
|
:subcategory "Keyboard"
|
|
:added "1.0"}
|
|
raw-key
|
|
"Contains the value of the most recent key on the keyboard that was
|
|
used (either pressed or released).
|
|
|
|
For non-ASCII keys, use the keyCode variable. The keys included in
|
|
the ASCII specification (BACKSPACE, TAB, ENTER, RETURN, ESC, and
|
|
DELETE) do not require checking to see if they key is coded, and you
|
|
should simply use the key variable instead of keyCode If you're
|
|
making cross-platform projects, note that the ENTER key is commonly
|
|
used on PCs and Unix and the RETURN key is used instead on
|
|
Macintosh. Check for both ENTER and RETURN to make sure your program
|
|
will work for all platforms."
|
|
[]
|
|
(.-key (ap/current-applet)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "rect()"
|
|
:category "Shape"
|
|
:subcategory "2D Primitives"
|
|
:added "1.0"}
|
|
rect
|
|
"Draws a rectangle to the screen. A rectangle is a four-sided shape
|
|
with every angle at ninety degrees. By default, the first two
|
|
parameters set the location of the upper-left corner, the third
|
|
sets the width, and the fourth sets the height. These parameters
|
|
may be changed with rect-mode.
|
|
|
|
To draw a rounded rectangle, add a fifth parameter, which is used as
|
|
the radius value for all four corners. To use a different radius value
|
|
for each corner, include eight parameters."
|
|
([x y width height]
|
|
(.rect (current-graphics) (float x) (float y) (float width) (float height)))
|
|
([x y width height r]
|
|
(.rect (current-graphics) (float x) (float y) (float width) (float height) (float r)))
|
|
([x y width height top-left-r top-right-r bottom-right-r bottom-left-r]
|
|
(.rect (current-graphics) (float x) (float y) (float width) (float height)
|
|
(float top-left-r) (float top-right-r) (float bottom-right-r) (float bottom-left-r))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "rectMode()"
|
|
:category "Shape"
|
|
:subcategory "Attributes"
|
|
:added "1.0"}
|
|
rect-mode
|
|
"Modifies the location from which rectangles draw. The default mode
|
|
is :corner. Available modes are:
|
|
|
|
|
|
:corner - Specifies the location to be the upper left corner of the
|
|
shape and uses the third and fourth parameters of rect to
|
|
specify the width and height.
|
|
|
|
:corners - Uses the first and second parameters of rect to set the
|
|
location of one corner and uses the third and fourth
|
|
parameters to set the opposite corner.
|
|
|
|
:center - Draws the image from its center point and uses the third
|
|
and forth parameters of rect to specify the image's width
|
|
and height.
|
|
|
|
:radius - Draws the image from its center point and uses the third
|
|
and forth parameters of rect() to specify half of the
|
|
image's width and height."
|
|
|
|
[mode]
|
|
(let [mode (u/resolve-constant-key mode rect-modes)]
|
|
(.rectMode (current-graphics) (int mode))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "red()"
|
|
:category "Color"
|
|
:subcategory "Creating & Reading"
|
|
:added "1.0"}
|
|
red
|
|
"Extracts the red value from a color, scaled to match current color-mode."
|
|
[c]
|
|
(.red (current-graphics) (unchecked-int c)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "redraw()"
|
|
:category "Structure"
|
|
:subcategory nil
|
|
:added "1.0"}
|
|
redraw
|
|
"Executes the code within the draw fn one time. This functions
|
|
allows the program to update the display window only when necessary,
|
|
for example when an event registered by mouse-pressed or
|
|
key-pressed occurs.
|
|
|
|
In structuring a program, it only makes sense to call redraw
|
|
within events such as mouse-pressed. This is because redraw does
|
|
not run draw immediately (it only sets a flag that indicates an
|
|
update is needed).
|
|
|
|
Calling redraw within draw has no effect because draw is
|
|
continuously called anyway."
|
|
[]
|
|
(.redraw (ap/current-applet)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "requestImage()"
|
|
:category "Image"
|
|
:subcategory "Loading & Displaying"
|
|
:added "1.0"}
|
|
request-image
|
|
"This function load images on a separate thread so that your sketch
|
|
does not freeze while images load during setup. While the image is
|
|
loading, its width and height will be 0. If an error occurs while
|
|
loading the image, its width and height will be set to -1. You'll
|
|
know when the image has loaded properly because its width and height
|
|
will be greater than 0. Asynchronous image loading (particularly
|
|
when downloading from a server) can dramatically improve
|
|
performance."
|
|
[filename] (.requestImage (ap/current-applet) (str filename)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "resetMatrix()"
|
|
:category "Transform"
|
|
:subcategory nil
|
|
:added "1.0"}
|
|
reset-matrix
|
|
"Replaces the current matrix with the identity matrix. The
|
|
equivalent function in OpenGL is glLoadIdentity()"
|
|
[]
|
|
(.resetMatrix (current-graphics)))
|
|
|
|
#?(:clj
|
|
(def ^{:private true}
|
|
shader-modes {:points PApplet/POINTS
|
|
:lines PApplet/LINES
|
|
:triangles PApplet/TRIANGLES}))
|
|
|
|
#?(:clj
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "resetShader()"
|
|
:category "Rendering"
|
|
:subcategory "Shaders"
|
|
:added "2.0"}
|
|
reset-shader
|
|
"Restores the default shaders. Code that runs after (reset-shader) will
|
|
not be affected by previously defined shaders. Optional 'kind' parameter -
|
|
type of shader, either :points, :lines, or :triangles"
|
|
([] (.resetShader (current-graphics)))
|
|
([kind]
|
|
(let [mode (u/resolve-constant-key kind shader-modes)]
|
|
(.resetShader (current-graphics) mode)))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "resize()"
|
|
:category "Image"
|
|
:processing-link "http://processing.org/reference/PImage_resize_.html"
|
|
:added "2.1.0"}
|
|
resize
|
|
"Resize the image to a new width and height.
|
|
To make the image scale proportionally, use 0 as the value for the wide or
|
|
high parameter. For instance, to make the width of an image 150 pixels,
|
|
and change the height using the same proportion, use resize(150, 0).
|
|
|
|
Even though a PGraphics is technically a PImage, it is not possible
|
|
to rescale the image data found in a PGraphics.
|
|
(It's simply not possible to do this consistently across renderers:
|
|
technically infeasible with P3D, or what would it even do with PDF?)
|
|
If you want to resize PGraphics content, first get a copy of its image data
|
|
using the get() method, and call resize() on the PImage that is returned."
|
|
[^PImage img w h]
|
|
(.resize img w h))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "rotate()"
|
|
:category "Transform"
|
|
:subcategory nil
|
|
:added "1.0"}
|
|
rotate
|
|
"Rotates a shape the amount specified by the angle parameter. Angles
|
|
should be specified in radians (values from 0 to TWO-PI) or
|
|
converted to radians with the radians function.
|
|
|
|
Objects are always rotated around their relative position to the
|
|
origin and positive numbers rotate objects in a clockwise
|
|
direction. Transformations apply to everything that happens after
|
|
and subsequent calls to the function accumulates the effect. For
|
|
example, calling (rotate HALF-PI) and then (rotate HALF-PI) is the
|
|
same as (rotate PI). All tranformations are reset when draw begins
|
|
again.
|
|
|
|
Technically, rotate multiplies the current transformation matrix by
|
|
a rotation matrix. This function can be further controlled by the
|
|
push-matrix and pop-matrix."
|
|
([angle] (.rotate (current-graphics) (float angle)))
|
|
([angle vx vy vz] (.rotate (current-graphics) (float angle)
|
|
(float vx) (float vy) (float vz))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "rotateX()"
|
|
:category "Transform"
|
|
:subcategory nil
|
|
:added "1.0"}
|
|
rotate-x
|
|
"Rotates a shape around the x-axis the amount specified by the angle
|
|
parameter. Angles should be specified in radians (values from 0 to
|
|
(* PI 2)) or converted to radians with the radians function. Objects
|
|
are always rotated around their relative position to the origin and
|
|
positive numbers rotate objects in a counterclockwise
|
|
direction. Transformations apply to everything that happens after
|
|
and subsequent calls to the function accumulates the effect. For
|
|
example, calling (rotate-x HALF-PI) and then (rotate-x HALF-PI) is
|
|
the same as (rotate-x PI). If rotate-x is called within the draw fn,
|
|
the transformation is reset when the loop begins again. This
|
|
function requires either the :p3d or :opengl renderer."
|
|
[angle]
|
|
(.rotateX (current-graphics) (float angle)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "rotateY()"
|
|
:category "Transform"
|
|
:subcategory nil
|
|
:added "1.0"}
|
|
rotate-y
|
|
"Rotates a shape around the y-axis the amount specified by the angle
|
|
parameter. Angles should be specified in radians (values from 0
|
|
to (* PI 2)) or converted to radians with the radians function.
|
|
Objects are always rotated around their relative position to the
|
|
origin and positive numbers rotate objects in a counterclockwise
|
|
direction. Transformations apply to everything that happens after
|
|
and subsequent calls to the function accumulates the effect. For
|
|
example, calling (rotate-y HALF-PI) and then (rotate-y HALF-PI) is
|
|
the same as (rotate-y PI). If rotate-y is called within the draw fn,
|
|
the transformation is reset when the loop begins again. This
|
|
function requires either the :p3d or :opengl renderer."
|
|
[angle]
|
|
(.rotateY (current-graphics) (float angle)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "rotateZ()"
|
|
:category "Transform"
|
|
:subcategory nil
|
|
:added "1.0"}
|
|
rotate-z
|
|
"Rotates a shape around the z-axis the amount specified by the angle
|
|
parameter. Angles should be specified in radians (values from 0
|
|
to (* PI 2)) or converted to radians with the radians function.
|
|
Objects are always rotated around their relative position to the
|
|
origin and positive numbers rotate objects in a counterclockwise
|
|
direction. Transformations apply to everything that happens after
|
|
and subsequent calls to the function accumulates the effect. For
|
|
example, calling (rotate-z HALF-PI) and then (rotate-z HALF-PI) is
|
|
the same as (rotate-z PI). If rotate-y is called within the draw fn,
|
|
the transformation is reset when the loop begins again. This
|
|
function requires either the :p3d or :opengl renderer."
|
|
[angle]
|
|
(.rotateZ (current-graphics) (float angle)))
|
|
|
|
(defn
|
|
^{:requires-bindings false
|
|
:processing-name "round()"
|
|
:category "Math"
|
|
:subcategory "Calculation"
|
|
:added "1.0"}
|
|
round
|
|
"Calculates the integer closest to the value parameter. For example,
|
|
(round 9.2) returns the value 9."
|
|
[val]
|
|
#?(:clj (PApplet/round (float val))
|
|
:cljs (.round (ap/current-applet) val)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "saturation()"
|
|
:category "Color"
|
|
:subcategory "Creating & Reading"
|
|
:added "1.0"}
|
|
saturation
|
|
"Extracts the saturation value from a color."
|
|
[c]
|
|
(.saturation (current-graphics) (unchecked-int c)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "save()"
|
|
:category "Output"
|
|
:subcategory "Image"
|
|
:added "1.0"}
|
|
save
|
|
"Saves an image from the display window. Images are saved in TIFF,
|
|
TARGA, JPEG, and PNG format depending on the extension within the
|
|
filename parameter. For example, image.tif will have a TIFF image
|
|
and image.png will save a PNG image. If no extension is included in
|
|
the filename, the image will save in TIFF format and .tif will be
|
|
added to the name. All images saved from the main drawing window
|
|
will be opaque. To save images without a background, use
|
|
create-graphics."
|
|
[filename]
|
|
(.save (current-graphics) (str filename)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "saveFrame()"
|
|
:category "Output"
|
|
:subcategory "Image"
|
|
:added "1.0"}
|
|
save-frame
|
|
"Saves an image identical to the current display window as a
|
|
file. May be called multple times - each file saved will have a
|
|
unique name. Name and image formate may be modified by passing a
|
|
string parameter of the form \"foo-####.ext\" where foo- can be any
|
|
arbitrary string, #### will be replaced with the current frame id
|
|
and .ext is one of .tiff, .targa, .png, .jpeg or .jpg
|
|
|
|
Examples:
|
|
(save-frame)
|
|
(save-frame \"pretty-pic-####.jpg\")"
|
|
([] (.saveFrame (ap/current-applet)))
|
|
([name] (.saveFrame (ap/current-applet) (str name))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "scale()"
|
|
:category "Transform"
|
|
:subcategory nil
|
|
:added "1.0"}
|
|
scale
|
|
"Increases or decreases the size of a shape by expanding and
|
|
contracting vertices. Objects always scale from their relative
|
|
origin to the coordinate system. Scale values are specified as
|
|
decimal percentages. For example, the function call (scale 2)
|
|
increases the dimension of a shape by 200%. Transformations apply to
|
|
everything that happens after and subsequent calls to the function
|
|
multiply the effect. For example, calling (scale 2) and then
|
|
(scale 1.5) is the same as (scale 3). If scale is called within
|
|
draw, the transformation is reset when the loop begins again. Using
|
|
this fuction with the z parameter requires specfying :p3d or :opengl
|
|
as the renderer. This function can be further controlled by
|
|
push-matrix and pop-matrix."
|
|
([s] (.scale (current-graphics) (float s)))
|
|
([sx sy] (.scale (current-graphics) (float sx) (float sy)))
|
|
([sx sy sz] (.scale (current-graphics) (float sx) (float sy) (float sz))))
|
|
|
|
#?(:clj
|
|
(defn- ^java.awt.Dimension current-screen
|
|
[]
|
|
(let [default-toolkit (java.awt.Toolkit/getDefaultToolkit)]
|
|
(.getScreenSize default-toolkit))))
|
|
|
|
#?(:clj
|
|
(defn
|
|
^{:requires-bindings false
|
|
:processing-name nil
|
|
:category "Environment"
|
|
:subcategory nil
|
|
:added "1.0"}
|
|
screen-width
|
|
"Returns the width of the main screen in pixels."
|
|
[]
|
|
(.width (current-screen))))
|
|
|
|
#?(:clj
|
|
(defn
|
|
^{:requires-bindings false
|
|
:processing-name nil
|
|
:category "Environment"
|
|
:subcategory nil
|
|
:added "1.0"}
|
|
screen-height
|
|
"Returns the height of the main screen in pixels."
|
|
[]
|
|
(.height (current-screen))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "screenX()"
|
|
:category "Lights, Camera"
|
|
:subcategory "Coordinates"
|
|
:added "1.0"}
|
|
screen-x
|
|
"Takes a three-dimensional x, y, z position and returns the x value
|
|
for where it will appear on a (two-dimensional) screen, once
|
|
affected by translate, scale or any other transformations"
|
|
([x y] (.screenX (current-graphics) (float x) (float y)))
|
|
([x y z] (.screenX (current-graphics) (float x) (float y) (float z))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "screenY()"
|
|
:category "Lights, Camera"
|
|
:subcategory "Coordinates"
|
|
:added "1.0"}
|
|
screen-y
|
|
"Takes a three-dimensional x, y, z position and returns the y value
|
|
for where it will appear on a (two-dimensional) screen, once
|
|
affected by translate, scale or any other transformations"
|
|
([x y] (.screenY (current-graphics) (float x) (float y)))
|
|
([x y z] (.screenY (current-graphics) (float x) (float y) (float z))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "screenZ()"
|
|
:category "Lights, Camera"
|
|
:subcategory "Coordinates"
|
|
:added "1.0"}
|
|
screen-z
|
|
"Given an x, y, z coordinate, returns its z value.
|
|
This value can be used to determine if an x, y, z coordinate is in
|
|
front or in back of another (x, y, z) coordinate. The units are
|
|
based on how the zbuffer is set up, and don't relate to anything
|
|
'real'. They're only useful for in comparison to another value
|
|
obtained from screen-z, or directly out of the zbuffer"
|
|
[x y z]
|
|
(.screenZ (current-graphics) (float x) (float y) (float z)))
|
|
|
|
(defn
|
|
^{:requires-bindings false
|
|
:processing-name "second()"
|
|
:category "Input"
|
|
:subcategory "Time & Date"
|
|
:added "1.0"}
|
|
seconds
|
|
"Returns the current second as a value from 0 - 59."
|
|
[]
|
|
#?(:clj (PApplet/second)
|
|
:cljs (.second (ap/current-applet))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "set()"
|
|
:category "Image"
|
|
:subcategory "Pixels"
|
|
:added "1.0"}
|
|
set-pixel
|
|
"Changes the color of any pixel in the display window. The x and y
|
|
parameters specify the pixel to change and the color parameter
|
|
specifies the color value. The color parameter is affected by the
|
|
current color mode (the default is RGB values from 0 to 255).
|
|
|
|
Setting the color of a single pixel with (set x, y) is easy, but not
|
|
as fast as putting the data directly into pixels[].
|
|
|
|
This function ignores imageMode().
|
|
|
|
Due to what appears to be a bug in Apple's Java implementation, the
|
|
point() and set() methods are extremely slow in some circumstances
|
|
when used with the default renderer. Using :p2d or :p3d will fix the
|
|
problem. Grouping many calls to point or set-pixel together can also
|
|
help. (Bug 1094)"
|
|
([x y c] (set-pixel (current-graphics) x y c))
|
|
([^PImage img x y c]
|
|
(.set img (int x) (int y) (int c))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "set()"
|
|
:category "Image"
|
|
:subcategory "Pixels"
|
|
:added "1.0"}
|
|
set-image
|
|
"Writes an image directly into the display window. The x and y
|
|
parameters define the coordinates for the upper-left corner of the
|
|
image."
|
|
[x y ^PImage src]
|
|
(.set (current-graphics) (int x) (int y) src))
|
|
|
|
#?(:clj
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "shader()"
|
|
:category "Rendering"
|
|
:subcategory "Shaders"
|
|
:added "2.0"}
|
|
shader
|
|
"Applies the shader specified by the parameters. It's compatible with the :p2d
|
|
and :p3drenderers, but not with the default :java2d renderer. Optional 'kind'
|
|
parameter - type of shader, either :points, :lines, or :triangles"
|
|
([shader] (.shader (current-graphics) shader))
|
|
([shader kind]
|
|
(let [mode (u/resolve-constant-key kind shader-modes)]
|
|
(.shader (current-graphics) shader mode)))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "shape()"
|
|
:category "Shape"
|
|
:subcategory "Loading & Displaying"
|
|
:added "1.0"}
|
|
shape
|
|
"Displays shapes to the screen. The shapes must have been loaded
|
|
with load-shape. Processing currently works with SVG shapes
|
|
only. The sh parameter specifies the shape to display and the x and
|
|
y parameters define the location of the shape from its upper-left
|
|
corner. The shape is displayed at its original size unless the width
|
|
and height parameters specify a different size. The shape-mode
|
|
fn changes the way the parameters work. A call to
|
|
(shape-mode :corners), for example, will change the width and height
|
|
parameters to define the x and y values of the opposite corner of
|
|
the shape.
|
|
|
|
Note complex shapes may draw awkwardly with the renderers :p2d, :p3d, and
|
|
:opengl. Those renderers do not yet support shapes that have holes
|
|
or complicated breaks."
|
|
([^PShape sh] (.shape (current-graphics) sh))
|
|
([^PShape sh x y] (.shape (current-graphics) sh (float x) (float y)))
|
|
([^PShape sh x y width height] (.shape (current-graphics) sh (float x) (float y) (float width) (float height))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "shearX()"
|
|
:category "Transform"
|
|
:subcategory nil
|
|
:added "1.0"}
|
|
shear-x
|
|
"Shears a shape around the x-axis the amount specified by the angle
|
|
parameter. Angles should be specified in radians (values from 0 to
|
|
PI*2) or converted to radians with the radians() function. Objects
|
|
are always sheared around their relative position to the origin and
|
|
positive numbers shear objects in a clockwise direction.
|
|
Transformations apply to everything that happens after and
|
|
subsequent calls to the function accumulates the effect. For
|
|
example, calling (shear-x (/ PI 2)) and then (shear-x (/ PI 2)) is
|
|
the same as (shear-x PI). If shear-x is called within the draw fn,
|
|
the transformation is reset when the loop begins again. This
|
|
function works in P2D or JAVA2D mode.
|
|
|
|
Technically, shear-x multiplies the current transformation matrix
|
|
by a rotation matrix. This function can be further controlled by the
|
|
push-matrix and pop-matrix fns."
|
|
[angle]
|
|
(.shearX (current-graphics) (float angle)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "shearY()"
|
|
:category "Transform"
|
|
:subcategory nil
|
|
:added "1.0"}
|
|
shear-y
|
|
"Shears a shape around the y-axis the amount specified by the angle
|
|
parameter. Angles should be specified in radians (values from 0 to
|
|
PI*2) or converted to radians with the radians() function. Objects
|
|
are always sheared around their relative position to the origin and
|
|
positive numbers shear objects in a clockwise direction.
|
|
Transformations apply to everything that happens after and
|
|
subsequent calls to the function accumulates the effect. For
|
|
example, calling (shear-y (/ PI 2)) and then (shear-y (/ PI 2)) is
|
|
the same as (shear-y PI). If shear-y is called within the draw fn,
|
|
the transformation is reset when the loop begins again. This
|
|
function works in P2D or JAVA2D mode.
|
|
|
|
Technically, shear-y multiplies the current transformation matrix
|
|
by a rotation matrix. This function can be further controlled by the
|
|
push-matrix and pop-matrix fns."
|
|
[angle]
|
|
(.shearY (current-graphics) (float angle)))
|
|
|
|
(defn ^{:requires-bindings true
|
|
:processing-name "shapeMode()"
|
|
:category "Shape"
|
|
:subcategory "Loading & Displaying"
|
|
:added "1.0"}
|
|
shape-mode
|
|
"Modifies the location from which shapes draw. Available modes are
|
|
:corner, :corners and :center. Default is :corner.
|
|
|
|
:corner - specifies the location to be the upper left corner of the
|
|
shape and uses the third and fourth parameters of shape
|
|
to specify the width and height.
|
|
|
|
:corners - uses the first and second parameters of shape to set
|
|
the location of one corner and uses the third and fourth
|
|
parameters to set the opposite corner.
|
|
|
|
:center - draws the shape from its center point and uses the third
|
|
and forth parameters of shape to specify the width and
|
|
height. "
|
|
[mode]
|
|
(let [mode (u/resolve-constant-key mode p-shape-modes)]
|
|
(.shapeMode (current-graphics) (int mode))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "shininess()"
|
|
:category "Lights, Camera"
|
|
:subcategory "Material Properties"
|
|
:added "1.0"}
|
|
shininess
|
|
"Sets the amount of gloss in the surface of shapes. Used in
|
|
combination with ambient, specular, and emissive in setting
|
|
the material properties of shapes."
|
|
[shine]
|
|
(.shininess (current-graphics) (float shine)))
|
|
|
|
(defn
|
|
^{:requires-bindings false
|
|
:processing-name "sin()"
|
|
:category "Math"
|
|
:subcategory "Trigonometry"
|
|
:added "1.0"}
|
|
sin
|
|
"Calculates the sine of an angle. This function expects the values
|
|
of the angle parameter to be provided in radians (values from 0 to
|
|
6.28). A float within the range -1 to 1 is returned."
|
|
[angle]
|
|
#?(:clj (PApplet/sin (float angle))
|
|
:cljs (.sin (ap/current-applet) angle)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "smooth()"
|
|
:category "Shape"
|
|
:subcategory "Attributes"
|
|
:added "1.0"}
|
|
smooth
|
|
"Draws all geometry with smooth (anti-aliased) edges. This will slow
|
|
down the frame rate of the application, but will enhance the visual
|
|
refinement.
|
|
|
|
Must be called inside :settings handler.
|
|
|
|
The level parameter (int) increases the level of smoothness with the
|
|
P2D and P3D renderers. This is the level of over sampling applied to
|
|
the graphics buffer. The value '2' will double the rendering size
|
|
before scaling it down to the display size. This is called '2x
|
|
anti-aliasing.' The value 4 is used for 4x anti-aliasing and 8 is
|
|
specified for 8x anti-aliasing. If level is set to 0, it will disable
|
|
all smoothing; it's the equivalent of the function noSmooth().
|
|
The maximum anti-aliasing level is determined by the hardware of the
|
|
machine that is running the software.
|
|
|
|
Note that smooth will also improve image quality of resized images."
|
|
([] (.smooth #?(:clj (ap/current-applet)
|
|
:cljs (current-graphics))))
|
|
([level] (.smooth #?(:clj (ap/current-applet)
|
|
:cljs (current-graphics))
|
|
(int level))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "specular()"
|
|
:category "Lights, Camera"
|
|
:subcategory "Material Properties"
|
|
:added "1.0"}
|
|
specular
|
|
"Sets the specular color of the materials used for shapes drawn to
|
|
the screen, which sets the color of hightlights. Specular refers to
|
|
light which bounces off a surface in a perferred direction (rather
|
|
than bouncing in all directions like a diffuse light). Used in
|
|
combination with emissive, ambient, and shininess in setting
|
|
the material properties of shapes."
|
|
([gray] (.specular (current-graphics) (float gray)))
|
|
([x y z] (.specular (current-graphics) (float x) (float y) (float z))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "sphere()"
|
|
:category "Shape"
|
|
:subcategory "3D Primitives"
|
|
:added "1.0"}
|
|
sphere
|
|
"Generates a hollow ball made from tessellated triangles."
|
|
[radius] (.sphere (current-graphics) (float radius)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "sphereDetail()"
|
|
:category "Shape"
|
|
:subcategory "3D Primitives"
|
|
:added "1.0"}
|
|
sphere-detail
|
|
"Controls the detail used to render a sphere by adjusting the number
|
|
of vertices of the sphere mesh. The default resolution is 30, which
|
|
creates a fairly detailed sphere definition with vertices every
|
|
360/30 = 12 degrees. If you're going to render a great number of
|
|
spheres per frame, it is advised to reduce the level of detail using
|
|
this function. The setting stays active until sphere-detail is
|
|
called again with a new parameter and so should not be called prior
|
|
to every sphere statement, unless you wish to render spheres with
|
|
different settings, e.g. using less detail for smaller spheres or
|
|
ones further away from the camera. To controla the detail of the
|
|
horizontal and vertical resolution independently, use the version of
|
|
the functions with two parameters."
|
|
([res] (.sphereDetail (current-graphics) (int res)))
|
|
([ures vres] (.sphereDetail (current-graphics) (int ures) (int vres))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "spotLight()"
|
|
:category "Lights, Camera"
|
|
:subcategory "Lights"
|
|
:added "1.0"}
|
|
spot-light
|
|
"Adds a spot light. Lights need to be included in the draw to
|
|
remain persistent in a looping program. Placing them in the setup
|
|
of a looping program will cause them to only have an effect the
|
|
first time through the loop. The affect of the r, g, and b
|
|
parameters is determined by the current color mode. The x, y, and z
|
|
parameters specify the position of the light and nx, ny, nz specify
|
|
the direction or light. The angle parameter affects angle of the
|
|
spotlight cone."
|
|
([r g b x y z nx ny nz angle concentration]
|
|
(.spotLight (current-graphics) r g b x y z nx ny nz angle concentration))
|
|
([[r g b] [x y z] [nx ny nz] angle concentration]
|
|
(.spotLight (current-graphics) r g b x y z nx ny nz angle concentration)))
|
|
|
|
(defn
|
|
^{:requires-bindings false
|
|
:processing-name "sq()"
|
|
:category "Math"
|
|
:subcategory "Calculation"
|
|
:added "1.0"}
|
|
sq
|
|
"Squares a number (multiplies a number by itself). The result is
|
|
always a positive number, as multiplying two negative numbers always
|
|
yields a positive result. For example, -1 * -1 = 1."
|
|
[a]
|
|
#?(:clj (PApplet/sq (float a))
|
|
:cljs (.sq (ap/current-applet) a)))
|
|
|
|
(defn
|
|
^{:requires-bindings false
|
|
:processing-name "sqrt()"
|
|
:category "Math"
|
|
:subcategory "Calculation"
|
|
:added "1.0"}
|
|
sqrt
|
|
"Calculates the square root of a number. The square root of a number
|
|
is always positive, even though there may be a valid negative
|
|
root. The square root s of number a is such that (= a (* s s)) . It
|
|
is the opposite of squaring."
|
|
[a]
|
|
#?(:clj (PApplet/sqrt (float a))
|
|
:cljs (.sqrt (ap/current-applet) a)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "loop()"
|
|
:category "Structure"
|
|
:subcategory nil
|
|
:added "1.0"}
|
|
start-loop
|
|
"Causes Processing to continuously execute the code within
|
|
draw. If no-loop is called, the code in draw stops executing."
|
|
[]
|
|
(.loop (ap/current-applet)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "stroke()"
|
|
:category "Color"
|
|
:subcategory "Setting"
|
|
:added "1.0"}
|
|
stroke-float
|
|
"Sets the color used to draw lines and borders around
|
|
shapes. Converts all args to floats"
|
|
([gray] (.stroke (current-graphics) (float gray)))
|
|
([gray alpha] (.stroke (current-graphics) (float gray) (float alpha)))
|
|
([x y z] (.stroke (current-graphics) (float x) (float y) (float z)))
|
|
([x y z a] (.stroke (current-graphics) (float x) (float y) (float z) (float a))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "stroke()"
|
|
:category "Color"
|
|
:subcategory "Setting"
|
|
:added "1.0"}
|
|
stroke-int
|
|
"Sets the color used to draw lines and borders around
|
|
shapes. Converts rgb to int and alpha to a float."
|
|
([rgb] (.stroke (current-graphics) (unchecked-int rgb)))
|
|
([rgb alpha] (.stroke (current-graphics) (unchecked-int rgb) (float alpha))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "stroke()"
|
|
:category "Color"
|
|
:subcategory "Setting"
|
|
:added "1.0"}
|
|
stroke
|
|
"Sets the color used to draw lines and borders around shapes. This
|
|
color is either specified in terms of the RGB or HSB color depending
|
|
on the current color-mode (the default color space is RGB, with
|
|
each value in the range from 0 to 255)."
|
|
([rgb]
|
|
#?(:clj (if (u/int-like? rgb) (stroke-int rgb) (stroke-float rgb))
|
|
:cljs (stroke-float rgb)))
|
|
|
|
([rgb alpha]
|
|
#?(:clj (if (u/int-like? rgb) (stroke-int rgb alpha) (stroke-float rgb alpha))
|
|
:cljs (stroke-float rgb alpha)))
|
|
|
|
([x y z] (stroke-float x y z))
|
|
([x y z a] (stroke-float x y z a)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "strokeCap()"
|
|
:category "Shape"
|
|
:subcategory "Attributes"
|
|
:added "1.0"}
|
|
stroke-cap
|
|
"Sets the style for rendering line endings. These ends are either
|
|
squared, extended, or rounded and specified with the corresponding
|
|
parameters :square, :project, and :round. The default cap is :round."
|
|
[cap-mode]
|
|
(let [cap-mode (u/resolve-constant-key cap-mode stroke-cap-modes)]
|
|
(.strokeCap (current-graphics)
|
|
#?(:clj (int cap-mode)
|
|
:cljs (str cap-mode)))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "strokeJoin()"
|
|
:category "Shape"
|
|
:subcategory "Attributes"
|
|
:added "1.0"}
|
|
stroke-join
|
|
"Sets the style of the joints which connect line
|
|
segments. These joints are either mitered, beveled, or rounded and
|
|
specified with the corresponding parameters :miter, :bevel, and
|
|
:round. The default joint is :miter.
|
|
|
|
This function is not available with the :p2d, :p3d, or :opengl
|
|
renderers."
|
|
[join-mode]
|
|
(let [join-mode (u/resolve-constant-key join-mode stroke-join-modes)]
|
|
(.strokeJoin (current-graphics)
|
|
#?(:clj (int join-mode)
|
|
:cljs (str join-mode)))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "strokeWeight()"
|
|
:category "Shape"
|
|
:subcategory "Attributes"
|
|
:added "1.0"}
|
|
stroke-weight
|
|
"Sets the width of the stroke used for lines, points, and the border
|
|
around shapes. All widths are set in units of pixels. "
|
|
[weight]
|
|
(.strokeWeight (current-graphics) (float weight)))
|
|
|
|
(defn
|
|
^{:requires-bindings false
|
|
:processing-name "tan()"
|
|
:category "Math"
|
|
:subcategory "Trigonometry"
|
|
:added "1.0"}
|
|
tan
|
|
"Calculates the ratio of the sine and cosine of an angle. This
|
|
function expects the values of the angle parameter to be provided in
|
|
radians (values from 0 to PI*2). Values are returned in the range
|
|
infinity to -infinity."
|
|
[angle]
|
|
#?(:clj (PApplet/tan (float angle))
|
|
:cljs (.tan (ap/current-applet) angle)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:category "Environment"
|
|
:subcategory nil
|
|
:added "1.5.0"}
|
|
target-frame-rate
|
|
"Returns the target framerate specified with the fn frame-rate"
|
|
[]
|
|
#?(:clj @(ap/target-frame-rate)
|
|
:cljs @(.-target-frame-rate (ap/current-applet))))
|
|
|
|
(defn- no-fill?
|
|
"Returns whether fill is disabled for current graphics."
|
|
[^PGraphics graphics]
|
|
#?(:clj (not (.-fill graphics))
|
|
:cljs (true? (aget graphics no-fill-prop))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "text()"
|
|
:category "Typography"
|
|
:subcategory "Loading & Displaying"
|
|
:added "1.0"}
|
|
text-char
|
|
"Draws a char to the screen in the specified position. See text fn
|
|
for more details."
|
|
([c x y]
|
|
(when-not (no-fill? (current-graphics))
|
|
(.text (current-graphics) (char c) (float x) (float y))))
|
|
([c x y z]
|
|
(when-not (no-fill? (current-graphics))
|
|
(.text (current-graphics) (char c) (float x) (float y) (float z)))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "text()"
|
|
:category "Typography"
|
|
:subcategory "Loading & Displaying"
|
|
:added "1.0"}
|
|
text-num
|
|
"Draws a number to the screen in the specified position. See text fn
|
|
for more details."
|
|
([num x y]
|
|
(when-not (no-fill? (current-graphics))
|
|
(.text (current-graphics) (float num) (float x) (float y))))
|
|
([num x y z]
|
|
(when-not (no-fill? (current-graphics))
|
|
(.text (current-graphics) (float num) (float x) (float y) (float z)))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "text()"
|
|
:category "Typography"
|
|
:subcategory "Loading & Displaying"
|
|
:added "1.0"}
|
|
text
|
|
"Draws text to the screen in the position specified by the x and y
|
|
parameters and the optional z parameter. A default font will be used
|
|
unless a font is set with the text-font fn. Change the color of the
|
|
text with the fill fn. The text displays in relation to the
|
|
text-align fn, which gives the option to draw to the left, right, and
|
|
center of the coordinates.
|
|
|
|
The x1, y1, x2 and y2 parameters define a
|
|
rectangular area to display within and may only be used with string
|
|
data. For text drawn inside a rectangle, the coordinates are
|
|
interpreted based on the current rect-mode setting."
|
|
([^String s x y]
|
|
(when-not (no-fill? (current-graphics))
|
|
(.text (current-graphics) s (float x) (float y))))
|
|
([^String s x y z]
|
|
(when-not (no-fill? (current-graphics))
|
|
(.text (current-graphics) s (float x) (float y) (float z))))
|
|
([^String s x1 y1 x2 y2]
|
|
(when-not (no-fill? (current-graphics))
|
|
(.text (current-graphics) s (float x1) (float y1) (float x2) (float y2)))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "textAlign()"
|
|
:category "Typography"
|
|
:subcategory "Attributes"
|
|
:added "1.0"}
|
|
text-align
|
|
"Sets the current alignment for drawing text. Available modes are:
|
|
|
|
horizontal - :left, :center, and :right
|
|
vertical - :top, :bottom, :center, and :baseline
|
|
|
|
An optional second parameter specifies the vertical alignment
|
|
mode. :baseline is the default. The :top and :center parameters are
|
|
straightforward. The :bottom parameter offsets the line based on the
|
|
current text-descent. For multiple lines, the final line will be
|
|
aligned to the bottom, with the previous lines appearing above it.
|
|
|
|
When using text with width and height parameters, :baseline is
|
|
ignored, and treated as :top. (Otherwise, text would by default draw
|
|
outside the box, since :baseline is the default setting. :baseline is
|
|
not a useful drawing mode for text drawn in a rectangle.)
|
|
|
|
The vertical alignment is based on the value of text-ascent, which
|
|
many fonts do not specify correctly. It may be necessary to use a
|
|
hack and offset by a few pixels by hand so that the offset looks
|
|
correct. To do this as less of a hack, use some percentage of
|
|
text-ascent or text-descent so that the hack works even if you
|
|
change the size of the font."
|
|
([align]
|
|
(let [align (u/resolve-constant-key align horizontal-alignment-modes)]
|
|
(.textAlign (current-graphics) (int align))))
|
|
([align-x align-y]
|
|
(let [align-x (u/resolve-constant-key align-x horizontal-alignment-modes)
|
|
align-y (u/resolve-constant-key align-y vertical-alignment-modes)]
|
|
(.textAlign (current-graphics) (int align-x) (int align-y)))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "textAscent()"
|
|
:category "Typography"
|
|
:subcategory "Metrics"
|
|
:added "1.0"}
|
|
text-ascent
|
|
"Returns the ascent of the current font at its current size. This
|
|
information is useful for determining the height of the font above
|
|
the baseline. For example, adding the text-ascent and text-descent
|
|
values will give you the total height of the line."
|
|
[]
|
|
(.textAscent (current-graphics)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "textDescent()"
|
|
:category "Typography"
|
|
:subcategory "Metrics"
|
|
:added "1.0"}
|
|
text-descent
|
|
"Returns descent of the current font at its current size. This
|
|
information is useful for determining the height of the font below
|
|
the baseline. For example, adding the text-ascent and text-descent
|
|
values will give you the total height of the line."
|
|
[]
|
|
(.textDescent (current-graphics)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "textFont()"
|
|
:category "Typography"
|
|
:subcategory "Loading & Displaying"
|
|
:added "1.0"}
|
|
text-font
|
|
"Sets the current font that will be drawn with the text
|
|
function. Fonts must be loaded with load-font before it can be
|
|
used. This font will be used in all subsequent calls to the text
|
|
function. If no size parameter is input, the font will appear at its
|
|
original size until it is changed with text-size.
|
|
|
|
Because fonts are usually bitmaped, you should create fonts at the
|
|
sizes that will be used most commonly. Using textFont without the
|
|
size parameter will result in the cleanest-looking text.
|
|
|
|
With the default (JAVA2D) and PDF renderers, it's also possible to
|
|
enable the use of native fonts via the command
|
|
(hint :enable-native-fonts). This will produce vector text in JAVA2D
|
|
sketches and PDF output in cases where the vector data is available:
|
|
when the font is still installed, or the font is created via the
|
|
create-font fn"
|
|
([^PFont font] (.textFont (current-graphics) font))
|
|
([^PFont font size] (.textFont (current-graphics) font (int size))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "textLeading()"
|
|
:category "Typography"
|
|
:subcategory "Attributes"
|
|
:added "1.0"}
|
|
text-leading
|
|
"Sets the spacing between lines of text in units of pixels. This
|
|
setting will be used in all subsequent calls to the text function."
|
|
[leading]
|
|
(.textLeading (current-graphics) (float leading)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "textMode()"
|
|
:category "Typography"
|
|
:subcategory "Attributes"
|
|
:added "1.0"}
|
|
text-mode
|
|
"Sets the way text draws to the screen - available modes
|
|
are :model and :shape
|
|
|
|
In the default configuration (the :model mode), it's possible to
|
|
rotate, scale, and place letters in two and three dimensional space.
|
|
|
|
The :shape mode draws text using the glyph outlines of individual
|
|
characters rather than as textures. This mode is only supported with
|
|
the PDF and OPENGL renderer settings. With the PDF renderer, you
|
|
must specify the :shape text-mode before any other drawing occurs.
|
|
If the outlines are not available, then :shape will be ignored and
|
|
:model will be used instead.
|
|
|
|
The :shape option in OPENGL mode can be combined with begin-raw to
|
|
write vector-accurate text to 2D and 3D output files, for instance
|
|
DXF or PDF. :shape is not currently optimized for OPENGL, so if
|
|
recording shape data, use :model until you're ready to capture the
|
|
geometry with begin-raw."
|
|
[mode]
|
|
(let [mode (u/resolve-constant-key mode text-modes)]
|
|
(.textMode (current-graphics) (int mode))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "textSize()"
|
|
:category "Typography"
|
|
:subcategory "Attributes"
|
|
:added "1.0"}
|
|
text-size
|
|
"Sets the current font size. This size will be used in all
|
|
subsequent calls to the text fn. Font size is measured in
|
|
units of pixels."
|
|
[size]
|
|
(.textSize (current-graphics) (float size)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "texture()"
|
|
:category "Shape"
|
|
:subcategory "Vertex"
|
|
:added "1.0"}
|
|
texture
|
|
"Sets a texture to be applied to vertex points. The texture fn must
|
|
be called between begin-shape and end-shape and before any calls to
|
|
vertex.
|
|
|
|
When textures are in use, the fill color is ignored. Instead, use
|
|
tint to specify the color of the texture as it is applied to the
|
|
shape."
|
|
#?(:clj [^PImage img]
|
|
:cljs [img])
|
|
(.texture (current-graphics) img))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "textureMode()"
|
|
:category "Shape"
|
|
:subcategory "Vertex"
|
|
:added "1.0"}
|
|
texture-mode
|
|
"Sets the coordinate space for texture mapping. There are two
|
|
options, :image and :normal.
|
|
|
|
:image refers to the actual coordinates of the image and :normal
|
|
refers to a normalized space of values ranging from 0 to 1. The
|
|
default mode is :image. In :image, if an image is 100 x 200 pixels,
|
|
mapping the image onto the entire size of a quad would require the
|
|
points (0,0) (0,100) (100,200) (0,200). The same mapping in
|
|
NORMAL_SPACE is (0,0) (0,1) (1,1) (0,1)."
|
|
[mode]
|
|
(let [mode (u/resolve-constant-key mode texture-modes)]
|
|
(.textureMode (current-graphics) (int mode))))
|
|
|
|
#?(:clj
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "textureWrap()"
|
|
:category "Shape"
|
|
:subcategory "Vertex"
|
|
:added "2.0"}
|
|
texture-wrap
|
|
"Defines if textures repeat or draw once within a texture map. The two
|
|
parameters are :clamp (the default behavior) and :repeat. This function
|
|
only works with the :p2d and :p3d renderers."
|
|
[mode]
|
|
(let [mode (u/resolve-constant-key mode texture-wrap-modes)]
|
|
(.textureWrap (current-graphics) mode))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "textWidth()"
|
|
:category "Typography"
|
|
:subcategory "Attributes"
|
|
:added "1.0"}
|
|
text-width
|
|
"Calculates and returns the width of any text string."
|
|
[^String data]
|
|
(.textWidth (current-graphics) data))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "tint()"
|
|
:category "Image"
|
|
:subcategory "Loading & Displaying"
|
|
:added "1.0"}
|
|
tint-float
|
|
"Sets the fill value for displaying images. Images can be tinted to
|
|
specified colors or made transparent by setting the alpha.
|
|
|
|
To make an image transparent, but not change it's color, use white
|
|
as the tint color and specify an alpha value. For instance,
|
|
tint(255, 128) will make an image 50% transparent (unless
|
|
colorMode() has been used).
|
|
|
|
The value for the parameter gray must be less than or equal to the
|
|
current maximum value as specified by colorMode(). The default
|
|
maximum value is 255.
|
|
|
|
Also used to control the coloring of textures in 3D."
|
|
([gray] (.tint (current-graphics) (float gray)))
|
|
([gray alpha] (.tint (current-graphics) (float gray) (float alpha)))
|
|
([r g b] (.tint (current-graphics) (float r)(float g) (float b)))
|
|
([r g b a] (.tint (current-graphics) (float g) (float g) (float b) (float a))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "tint()"
|
|
:category "Image"
|
|
:subcategory "Loading & Displaying"
|
|
:added "1.0"}
|
|
tint-int
|
|
"Sets the fill value for displaying images. Images can be tinted to
|
|
specified colors or made transparent by setting the alpha.
|
|
|
|
To make an image transparent, but not change it's color, use white
|
|
as the tint color and specify an alpha value. For instance,
|
|
tint(255, 128) will make an image 50% transparent (unless
|
|
colorMode() has been used).
|
|
|
|
The value for the parameter gray must be less than or equal to the
|
|
current maximum value as specified by colorMode(). The default
|
|
maximum value is 255.
|
|
|
|
Also used to control the coloring of textures in 3D."
|
|
([rgb] (.tint (current-graphics) (unchecked-int rgb)))
|
|
([rgb alpha] (.tint (current-graphics) (unchecked-int rgb) (float alpha))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "tint()"
|
|
:category "Image"
|
|
:subcategory "Loading & Displaying"
|
|
:added "1.0"}
|
|
tint
|
|
"Sets the fill value for displaying images. Images can be tinted to
|
|
specified colors or made transparent by setting the alpha.
|
|
|
|
To make an image transparent, but not change it's color, use white
|
|
as the tint color and specify an alpha value. For instance,
|
|
tint(255, 128) will make an image 50% transparent (unless
|
|
colorMode() has been used).
|
|
|
|
The value for the parameter gray must be less than or equal to the
|
|
current maximum value as specified by colorMode(). The default
|
|
maximum value is 255.
|
|
|
|
Also used to control the coloring of textures in 3D."
|
|
#?(:clj ([rgb] (if (u/int-like? rgb) (tint-int rgb) (tint-float rgb)))
|
|
:cljs ([rgb] (.tint (current-graphics) rgb)))
|
|
#?(:clj ([rgb alpha] (if (u/int-like? rgb) (tint-int rgb alpha) (tint-float rgb alpha)))
|
|
:cljs ([rgb alpha] (.tint (current-graphics) rgb alpha)))
|
|
([r g b] (tint-float r g b))
|
|
([r g b a] (tint-float r g b a)))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "translate()"
|
|
:category "Transform"
|
|
:subcategory nil
|
|
:added "1.0"}
|
|
translate
|
|
"Specifies an amount to displace objects within the display
|
|
window. The x parameter specifies left/right translation, the y
|
|
parameter specifies up/down translation, and the z parameter
|
|
specifies translations toward/away from the screen. Transformations
|
|
apply to everything that happens after and subsequent calls to the
|
|
function accumulates the effect. For example, calling (translate 50
|
|
0) and then (translate 20, 0) is the same as (translate 70, 0). If
|
|
translate is called within draw, the transformation is reset when
|
|
the loop begins again. This function can be further controlled by
|
|
the push-matrix and pop-matrix."
|
|
([v] (apply translate v))
|
|
([tx ty] (.translate (current-graphics) (float tx) (float ty)))
|
|
([tx ty tz] (.translate (current-graphics) (float tx) (float ty) (float tz))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "triangle()"
|
|
:category "Shape"
|
|
:subcategory "2D Primitives"
|
|
:added "1.0"}
|
|
triangle
|
|
"A triangle is a plane created by connecting three points. The first
|
|
two arguments specify the first point, the middle two arguments
|
|
specify the second point, and the last two arguments specify the
|
|
third point."
|
|
[x1 y1 x2 y2 x3 y3]
|
|
(.triangle (current-graphics)
|
|
(float x1) (float y1)
|
|
(float x2) (float y2)
|
|
(float x3) (float y3)))
|
|
|
|
(defn
|
|
^{:require-binding false
|
|
:processing-name "unbinary()"
|
|
:category "Data"
|
|
:subcategory "Conversion"
|
|
:added "1.0"}
|
|
unbinary
|
|
"Unpack a binary string to an integer. See binary for converting
|
|
integers to strings."
|
|
[str-val]
|
|
#?(:clj (PApplet/unbinary (str str-val))
|
|
:cljs (.unbinary (ap/current-applet) (str str-val))))
|
|
|
|
(defn
|
|
^{:require-binding false
|
|
:processing-name "hex()"
|
|
:category "Data"
|
|
:subcategory "Conversion"}
|
|
unhex
|
|
"Converts a String representation of a hexadecimal number to its
|
|
equivalent integer value."
|
|
[hex-str]
|
|
#?(:clj (PApplet/unhex (str hex-str))
|
|
:cljs (.unhex (ap/current-applet) (str hex-str))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "updatePixels()"
|
|
:category "Image"
|
|
:subcategory "Pixels"
|
|
:added "1.0"}
|
|
update-pixels
|
|
"Updates the display window or image with the data in the pixels array.
|
|
Use in conjunction with (pixels). If you're only reading pixels from
|
|
the array, there's no need to call update-pixels unless there are
|
|
changes.
|
|
|
|
Certain renderers may or may not seem to require pixels or
|
|
update-pixels. However, the rule is that any time you want to
|
|
manipulate the pixels array, you must first call pixels, and
|
|
after changes have been made, call update-pixels. Even if the
|
|
renderer may not seem to use this function in the current Processing
|
|
release, this will always be subject to change."
|
|
([] (update-pixels (current-graphics)))
|
|
#?(:clj
|
|
([^PImage img] (.updatePixels img))
|
|
|
|
:cljs
|
|
([img]
|
|
(when-let [pix-array (.-stored-pix-array img)]
|
|
(.set (.-pixels img) pix-array)
|
|
(set! (.-stored-pix-array img) nil))
|
|
(.updatePixels img))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "vertex()"
|
|
:category "Shape"
|
|
:subcategory "Vertex"
|
|
:added "1.0"}
|
|
vertex
|
|
"All shapes are constructed by connecting a series of
|
|
vertices. vertex is used to specify the vertex coordinates for
|
|
points, lines, triangles, quads, and polygons and is used
|
|
exclusively within the begin-shape and end-shape fns.
|
|
|
|
Drawing a vertex in 3D using the z parameter requires the :p3d or
|
|
:opengl renderers to be used.
|
|
|
|
This function is also used to map a texture onto the geometry. The
|
|
texture fn declares the texture to apply to the geometry and the u
|
|
and v coordinates set define the mapping of this texture to the
|
|
form. By default, the coordinates used for u and v are specified in
|
|
relation to the image's size in pixels, but this relation can be
|
|
changed with texture-mode."
|
|
([x y] (.vertex (current-graphics) (float x) (float y)))
|
|
([x y z] (.vertex (current-graphics) (float x) (float y) (float z)))
|
|
([x y u v] (.vertex (current-graphics) (float x) (float y) (float u) (float v)))
|
|
([x y z u v]
|
|
(.vertex (current-graphics) (float x) (float y) (float z) (float u) (float v))))
|
|
|
|
(defn
|
|
^{:requires-bindings false
|
|
:processing-name "year()"
|
|
:category "Input"
|
|
:subcategory "Time & Date"
|
|
:added "1.0"}
|
|
year
|
|
"Returns the current year as an integer (2003, 2004, 2005, etc)."
|
|
[]
|
|
#?(:clj (PApplet/year)
|
|
:cljs (.year (ap/current-applet))))
|
|
|
|
(defn
|
|
^{:requires-bindings true
|
|
:processing-name "getWidth()"
|
|
:processing-link nil
|
|
:category "Environment"
|
|
:subcategory nil
|
|
:added "1.0"}
|
|
width
|
|
"Width of the display window. The value of width is zero until size is
|
|
called."
|
|
[]
|
|
(.-width (ap/current-applet)))
|
|
|
|
(defmacro
|
|
^{:requires-bindings true
|
|
:processing-name nil
|
|
:category "Color"
|
|
:subcategory "Utility Macros"
|
|
:added "1.7"}
|
|
with-fill
|
|
"Temporarily set the fill color for the body of this macro.
|
|
The code outside of with-fill form will have the previous fill color set.
|
|
|
|
The fill color has to be in a vector!
|
|
Example: (with-fill [255] ...)
|
|
(with-fill [10 80 98] ...)"
|
|
[fill-args & body]
|
|
`(let [old-fill# (quil.core/current-fill)]
|
|
(apply quil.core/fill ~fill-args)
|
|
~@body
|
|
(quil.core/fill old-fill#)))
|
|
|
|
(defmacro
|
|
^{:requires-bindings true
|
|
:processing-name nil
|
|
:category "Color"
|
|
:subcategory "Utility Macros"
|
|
:added "1.7"}
|
|
with-stroke
|
|
"Temporarily set the stroke color for the body of this macro.
|
|
The code outside of with-stroke form will have the previous stroke color set.
|
|
|
|
The stroke color has to be in a vector!
|
|
Example: (with-stroke [255] ...)
|
|
(with-stroke [10 80 98] ...)"
|
|
[stroke-args & body]
|
|
`(let [old-stroke# (quil.core/current-stroke)]
|
|
(apply quil.core/stroke ~stroke-args)
|
|
~@body
|
|
(quil.core/stroke old-stroke#)))
|
|
|
|
(defmacro
|
|
^{:requires-bindings true
|
|
:processing-name nil
|
|
:category "Transform"
|
|
:subcategory "Utility Macros"
|
|
:added "1.0"}
|
|
with-translation
|
|
"Performs body with translation, restores current transformation on
|
|
exit."
|
|
[translation-vector & body]
|
|
`(let [tr# ~translation-vector]
|
|
(quil.core/push-matrix)
|
|
(try
|
|
(quil.core/translate tr#)
|
|
~@body
|
|
(finally
|
|
(quil.core/pop-matrix)))))
|
|
|
|
(defmacro
|
|
^{:requires-bindings true
|
|
:processing-name nil
|
|
:category "Transform"
|
|
:subcategory "Utility Macros"
|
|
:added "1.0"}
|
|
with-rotation
|
|
"Performs body with rotation, restores current transformation on exit.
|
|
Accepts a vector [angle] or [angle x-axis y-axis z-axis].
|
|
|
|
Example:
|
|
(with-rotation [angle]
|
|
(vertex 1 2))"
|
|
[rotation & body]
|
|
`(let [tr# ~rotation]
|
|
(quil.core/push-matrix)
|
|
(try
|
|
(apply quil.core/rotate tr#)
|
|
~@body
|
|
(finally
|
|
(quil.core/pop-matrix)))))
|
|
|
|
(defmacro
|
|
^{:requires-bindings true
|
|
:processing-name nil
|
|
:category "Rendering"
|
|
:added "1.7"}
|
|
with-graphics
|
|
"All subsequent calls of any drawing function will draw on given
|
|
graphics. 'with-graphics' cannot be nested (you can draw simultaneously
|
|
only on 1 graphics)"
|
|
[graphics & body]
|
|
`(let [gr# ~graphics]
|
|
(binding [quil.core/*graphics* gr#]
|
|
(.beginDraw gr#)
|
|
~@body
|
|
(.endDraw gr#))))
|
|
|
|
(defn ^{:requires-bindings false
|
|
:category "Environment"
|
|
:subcategory nil
|
|
:added "1.0"}
|
|
sketch
|
|
"Create and start a new visualisation applet. Can be used to create
|
|
new sketches programmatically. See documentation for 'defsketch' for
|
|
list of available options."
|
|
[& opts]
|
|
#?(:clj (apply ap/applet opts)
|
|
:cljs (apply ap/sketch opts)))
|
|
|
|
(defmacro ^{:requires-bindings false
|
|
:category "Environment"
|
|
:subcategory nil
|
|
:added "1.0"}
|
|
defsketch
|
|
"Define and start a sketch and bind it to a var with the symbol
|
|
app-name. If any of the options to the various callbacks are
|
|
symbols, it wraps them in a call to var to ensure they aren't
|
|
inlined and that redefinitions to the original fns are reflected in
|
|
the visualisation.
|
|
|
|
Available options:
|
|
|
|
:size - A vector of width and height for the sketch or :fullscreen.
|
|
Defaults to [500 300]. If you're using :fullscreen you may
|
|
want to enable present mode - :features [:present]
|
|
|
|
:renderer - Specifies the renderer type. One of :p2d, :p3d, :java2d,
|
|
:opengl, :pdf). Defaults to :java2d. :dxf renderer
|
|
can't be used as sketch renderer. Use begin-raw method
|
|
instead. In clojurescript only :p2d and :p3d renderers
|
|
are supported.
|
|
|
|
:output-file - Specifies an output file path. Only used in :pdf mode.
|
|
Not supported in clojurescript.
|
|
|
|
:title - A string which will be displayed at the top of
|
|
the sketch window. Not supported in clojurescript.
|
|
|
|
:features - A vector of keywords customizing sketch behaviour.
|
|
Supported features:
|
|
|
|
:keep-on-top - Sketch window will always be above other
|
|
windows. Note: some platforms might not
|
|
support always-on-top windows.
|
|
Not supported in clojurescript.
|
|
|
|
:exit-on-close - Shutdown JVM when sketch is closed.
|
|
Not supported in clojurescript.
|
|
|
|
:resizable - Makes sketch resizable.
|
|
Not supported in clojurescript.
|
|
|
|
:no-safe-fns - Do not catch and print exceptions thrown
|
|
inside functions provided to sketch (like
|
|
draw, mouse-click, key-pressed and
|
|
other). By default all exceptions thrown
|
|
inside these functions are catched. This
|
|
prevents sketch from breaking when bad
|
|
function was provided and allows you to
|
|
fix it and reload it on fly. You can
|
|
disable this behaviour by enabling
|
|
:no-safe-fns feature.
|
|
Not supported in clojurescript.
|
|
|
|
:present - Switch to present mode (fullscreen without
|
|
borders, OS panels). You may want to use
|
|
this feature together with :size :fullscreen.
|
|
Not supported in clojurescript.
|
|
|
|
:no-start - Disables autostart if sketch was created using
|
|
defsketch macro. To start sketch you have to
|
|
call function created defsketch.
|
|
Supported only in clojurescript.
|
|
|
|
:global-key-events - Allows a sketch to receive any
|
|
keyboard event sent to the page,
|
|
regardless of whether the canvas it is
|
|
loaded in has focus or not.
|
|
Supported only in clojurescript.
|
|
|
|
Usage example: :features [:keep-on-top :present]
|
|
|
|
:bgcolor - Sets background color for unused space in present mode.
|
|
Color is specified in hex format: #XXXXXX.
|
|
Example: :bgcolor \"#00FFFF\" (cyan background)
|
|
Not supported in clojurescript.
|
|
|
|
:display - Sets what display should be used by this sketch.
|
|
Displays are numbered starting from 0. Example: :display 1.
|
|
Not supported in clojurescript.
|
|
|
|
:setup - A function to be called once when setting the sketch up.
|
|
|
|
:draw - A function to be repeatedly called at most n times per
|
|
second where n is the target frame-rate set for
|
|
the visualisation.
|
|
|
|
:host - String id of canvas element or DOM element itself.
|
|
Specifies host for the sketch. Must be specified in sketch,
|
|
may be omitted in defsketch. If ommitted in defsketch,
|
|
:host is set to the name of the sketch. If element with
|
|
specified id is not found on the page and page is empty -
|
|
new canvas element will be created. Used in clojurescript.
|
|
|
|
:focus-gained - Called when the sketch gains focus.
|
|
Not supported in clojurescript.
|
|
|
|
:focus-lost - Called when the sketch loses focus.
|
|
Not supported in clojurescript.
|
|
|
|
:mouse-entered - Called when the mouse enters the sketch window.
|
|
|
|
:mouse-exited - Called when the mouse leaves the sketch window
|
|
|
|
:mouse-pressed - Called every time a mouse button is pressed.
|
|
|
|
:mouse-released - Called every time a mouse button is released.
|
|
|
|
:mouse-clicked - called once after a mouse button has been pressed
|
|
and then released.
|
|
|
|
:mouse-moved - Called every time the mouse moves and a button is
|
|
not pressed.
|
|
|
|
:mouse-dragged - Called every time the mouse moves and a button is
|
|
pressed.
|
|
|
|
:mouse-wheel - Called every time mouse wheel is rotated.
|
|
Takes 1 argument - wheel rotation, an int.
|
|
Negative values if the mouse wheel was rotated
|
|
up/away from the user, and positive values
|
|
if the mouse wheel was rotated down/ towards the user
|
|
|
|
:key-pressed - Called every time any key is pressed.
|
|
|
|
:key-released - Called every time any key is released.
|
|
|
|
:key-typed - Called once every time non-modifier keys are
|
|
pressed.
|
|
|
|
:on-close - Called once, when sketch is closed
|
|
Not supported in clojurescript.
|
|
|
|
:middleware - Vector of middleware to be applied to the sketch.
|
|
Middleware will be applied in the same order as in comp
|
|
function: [f g] will be applied as (f (g options)).
|
|
|
|
:settings - cousin of :setup. A function to be called once when
|
|
setting sketch up. Should be used only for (smooth) and
|
|
(no-smooth). Due to Processing limitations these functions
|
|
cannot be used neither in :setup nor in :draw."
|
|
[app-name & options]
|
|
#?(:clj
|
|
(if (u/clj-compilation?)
|
|
`(ap/defapplet ~app-name ~@options)
|
|
`(quil.sketch/defsketch ~app-name ~@options))
|
|
:cljs
|
|
`(quil.sketch$macros/defsketch ~app-name ~@options)))
|
|
|
|
(defn ^{:requires-bindings false
|
|
:processing-name nil
|
|
:category "Input"
|
|
:subcategory "Keyboard"
|
|
:added "1.6"}
|
|
key-coded?
|
|
"Returns true if char c is a 'coded' char i.e. it is necessary to
|
|
fetch the key-code as an integer and use that to determine the
|
|
specific key pressed. See key-keyword."
|
|
[c]
|
|
#?(:clj (= PConstants/CODED (int c))
|
|
; See https://github.com/google/closure-compiler/issues/1676
|
|
:cljs (= 65535 (.charCodeAt (js/String c)))))
|
|
|
|
(defn ^{:requires-bindings true
|
|
:processing-name nil
|
|
:category "Input"
|
|
:subcategory "Keyboard"
|
|
:added "1.6"}
|
|
key-as-keyword
|
|
"Returns a keyword representing the currently pressed key. Modifier
|
|
keys are represented as: :up, :down, :left, :right, :alt, :control,
|
|
:shift, :command, :f1-24"
|
|
[]
|
|
(let [key-char (raw-key)
|
|
code (key-code)]
|
|
(if (key-coded? key-char)
|
|
(get KEY-CODES code :unknown-key)
|
|
; Workaround for closure compiler incorrect string casts.
|
|
; See https://github.com/google/closure-compiler/issues/1676
|
|
(keyword #?(:clj (str key-char)
|
|
:cljs (js/String key-char))))))
|
|
|
|
#?(:clj
|
|
(defn
|
|
^{:requires-bindings false
|
|
:processing-name nil
|
|
:category "Debugging"
|
|
:added "1.6"}
|
|
debug
|
|
"Prints msg and then sleeps the current thread for delay-ms. Useful
|
|
for debugging live running sketches. delay-ms defaults to 300. "
|
|
([msg] (debug msg 300))
|
|
([msg delay-ms]
|
|
(println msg)
|
|
(Thread/sleep delay-ms))))
|
|
|
|
;;; doc utils
|
|
|
|
#?(:clj
|
|
(def ^{:private true}
|
|
fn-metas
|
|
"Returns a seq of metadata maps for all fns related to the original
|
|
Processing API (but may not have a direct Processing API equivalent)."
|
|
(->> *ns* ns-publics vals (map meta))))
|
|
|
|
#?(:clj
|
|
(defn show-cats
|
|
"Print out a list of all the categories and subcategories,
|
|
associated index nums and fn count (in parens)."
|
|
[]
|
|
(doseq [[cat-idx cat] (docs/sorted-category-map fn-metas)]
|
|
(println cat-idx (:name cat))
|
|
(doseq [[subcat-idx subcat] (:subcategories cat)]
|
|
(println " " subcat-idx (:name subcat))))))
|
|
|
|
#?(:clj
|
|
(defn show-fns
|
|
"If given a number, print all the functions within category or
|
|
subcategory specified by the category index (use show-cats to see a
|
|
list of index nums).
|
|
|
|
If given a string or a regular expression, print all the functions
|
|
whose name or category name contains that string.
|
|
|
|
If a category is specified, it will not print out the fns in any of
|
|
cat's subcategories."
|
|
[q]
|
|
(letfn [(list-category [cid c & {:keys [only]}]
|
|
(let [category-fns (:fns c)
|
|
display-fns (if (nil? only)
|
|
category-fns
|
|
(clojure.set/intersection
|
|
(set only) (set category-fns)))
|
|
names (sort (map str display-fns))]
|
|
(when-not (empty? names))
|
|
(println cid (:name c))
|
|
(docs/pprint-wrapped-lines names :fromcolumn 4)))
|
|
(show-fns-by-cat-idx [cat-idx]
|
|
(let [c (get (docs/all-category-map fn-metas) (str cat-idx))]
|
|
(list-category cat-idx c)))
|
|
(show-fns-by-name-regex [re]
|
|
(doseq [[cid c] (sort-by key (docs/all-category-map fn-metas))]
|
|
(let [in-cat-name? (re-find re (:name c))
|
|
matching-fns (filter #(re-find re (str %)) (:fns c))
|
|
in-fn-names? (not (empty? matching-fns))]
|
|
(cond
|
|
in-cat-name? (list-category cid c) ;; print an entire category
|
|
in-fn-names? (list-category cid c :only matching-fns)))))]
|
|
(cond
|
|
(string? q) (show-fns-by-name-regex (re-pattern (str "(?i)" q)))
|
|
(isa? (type q) java.util.regex.Pattern) (show-fns-by-name-regex q)
|
|
:else (show-fns-by-cat-idx q)))))
|
|
|
|
#?(:clj
|
|
(defn show-meths
|
|
"Takes a string representing the start of a method name in the
|
|
original Processing API and prints out all matches alongside the
|
|
Processing-core equivalent."
|
|
[orig-name]
|
|
(let [res (docs/matching-processing-methods fn-metas orig-name)]
|
|
(u/print-definition-list res))))
|