From ce9d6e8ad28b2d84d1a292a871c23b66a4654b54 Mon Sep 17 00:00:00 2001 From: David Thompson Date: Tue, 13 Apr 2021 11:30:50 -0400 Subject: Add new guile-sdl2 and chickadee releases. --- manuals/chickadee/3D-Models.html | 6 +- manuals/chickadee/9_002dPatches.html | 131 ++++++++++++++++++++++++++++++++ manuals/chickadee/Basics.html | 2 +- manuals/chickadee/Bezier-Curves.html | 2 +- manuals/chickadee/Blending.html | 116 +++++++++++++++++++++++----- manuals/chickadee/Buffers.html | 6 +- manuals/chickadee/Easings.html | 2 +- manuals/chickadee/Fonts.html | 10 +-- manuals/chickadee/Framebuffers.html | 2 +- manuals/chickadee/Graphics.html | 19 +++-- manuals/chickadee/Grid.html | 10 +-- manuals/chickadee/Index.html | 43 +++++++++-- manuals/chickadee/Math.html | 12 +-- manuals/chickadee/Matrices.html | 118 ++++++++++++++++++++++++++-- manuals/chickadee/Particles.html | 16 ++-- manuals/chickadee/Path-Finding.html | 8 +- manuals/chickadee/Quaternions.html | 2 +- manuals/chickadee/Rectangles.html | 6 +- manuals/chickadee/Rendering-Engine.html | 24 +++--- manuals/chickadee/Shaders.html | 12 +-- manuals/chickadee/Sprites.html | 47 ++---------- manuals/chickadee/The-Game-Loop.html | 14 ++-- manuals/chickadee/Tile-Maps.html | 39 ++++++++-- manuals/chickadee/Vector-Paths.html | 10 +-- manuals/chickadee/Vectors.html | 8 +- manuals/chickadee/Viewports.html | 2 +- manuals/chickadee/index.html | 48 ++++++------ 27 files changed, 525 insertions(+), 190 deletions(-) create mode 100644 manuals/chickadee/9_002dPatches.html (limited to 'manuals/chickadee') diff --git a/manuals/chickadee/3D-Models.html b/manuals/chickadee/3D-Models.html index ef1a2cb..6d0f7c7 100644 --- a/manuals/chickadee/3D-Models.html +++ b/manuals/chickadee/3D-Models.html @@ -33,7 +33,7 @@ http://www.texinfo.org/ (GNU Texinfo). - + + + + + + + + +

2.3.4 9-Patches

+ +

A 9-patch is a method of rendering a texture so that it can be +stretched to cover an area of any size without becoming distorted. +This is achieved by dividing up the sprite into nine regions: +

the center, which can be stretched or tiled horizontally and vertically +
the four corners, which are never stretched or tiled +
the left and right sides, which can be stretched or tiled vertically +
the top and bottom sides, which can be stretched or tiled horizontally +

+ +

The most common application of this technique is for graphical user +interface widgets like buttons and dialog boxes which are often +dynamically resizable. By using a 9-patch, they can be rendered at +any size without scaling artifacts. +

Procedure: draw-nine-patch texture rect [#:margin 0] [#:top-margin margin] [#:bottom-margin margin] [#:left-margin margin] [#:right-margin margin] [#:mode stretch] [#:origin] [#:scale] [#:rotation] [#:blend-mode] [#:tint white]

Draw a 9-patch over the area rect using texture whose +stretchable/tileable patches are defined by the given margin +measurements. The corners are never stretched/tiled, the left and +right edges will be stretched/tiled vertically, the top and bottom +edges may be stretched/tiled horizontally, and the center may be +stretched/tiled in both directions. +

mode may be either stretch (the default) or tile. +

margin specifies the margin size for all sides of the 9-patch. +To make margins of differing sizes, the top-margin, +bottom-margin, left-margin, and right-margin +arguments may be used. +

Refer to draw-sprite (see Sprites) for information about +the other arguments as they are the same. +

+ + + + + + diff --git a/manuals/chickadee/Basics.html b/manuals/chickadee/Basics.html index 22fe5c7..e258de2 100644 --- a/manuals/chickadee/Basics.html +++ b/manuals/chickadee/Basics.html @@ -129,7 +129,7 @@ factor alpha, a number in the range [0, 1].

Procedure: degrees->radians radians
Procedure: radians->degrees radians: Convert radians to degrees.

diff --git a/manuals/chickadee/Bezier-Curves.html b/manuals/chickadee/Bezier-Curves.html index b424dac..cb413cf 100644 --- a/manuals/chickadee/Bezier-Curves.html +++ b/manuals/chickadee/Bezier-Curves.html @@ -85,7 +85,7 @@ ul.no-bullet {list-style: none} Next: Path Finding, Previous: Easings, Up: Math [Contents][Index]

2.2.8 Bezier Curves

2.2.7 Bezier Curves

The (chickadee math bezier) module provides an API for describing cubic Bezier curves in 2D space. These curves are notably diff --git a/manuals/chickadee/Blending.html b/manuals/chickadee/Blending.html index 4cf13a7..0a54bbe 100644 --- a/manuals/chickadee/Blending.html +++ b/manuals/chickadee/Blending.html @@ -85,40 +85,118 @@ ul.no-bullet {list-style: none} Next: Framebuffers, Previous: 3D Models, Up: Graphics [Contents][Index]

2.3.9 Blending

2.3.10 Blending

Rendering a scene often involves drawing layers of objects that overlap each other. Blending determines how two overlapping pixels are combined in the final image that is rendered to the screen. -Chickadee provides the following blend modes:

replace -Use the latest color, ignoring all others. - -
alpha -Blend pixels according to the values of their alpha channels. This is -the most commonly used blend mode and thus is Chickadee’s default -mode. - -
add -Add all pixel color values together. The more colors blended +
Chickadee provides the following blend modes: +
+
+
Variable: blend:alpha
+
Blend pixels according to the values of their alpha channels. This is +the most commonly used blend mode. +
+ +
+
Variable: blend:replace
+
Overwrite the output pixel color with the color being drawn. +
+ +
+
Variable: blend:add
+
Add all pixel color values together. The more colors blended together, the more white the final color becomes. +
-
subtract -Subtract all pixel color values. The more colors blended together, +
+
Variable: blend:subtract
+
Subtract all pixel color values. The more colors blended together, the more black the final color becomes. +
-
multiply +
+
Variable: blend:multiply
+
-
darken +
+
Variable: blend:darken
+
-
lighten +
+
Variable: blend:lighten
+
-
screen +
+
Variable: blend:screen
+
+
Custom blend modes can be created using the make-blend-mode procedure: +
+
+
Procedure: make-blend-mode equation source-function destination-function
+
Return a new custom blend mode that applies source-function to +the source color, destination-function to the destination color, +and finally applies equation to the transformed +source/destination color values. These arguments are not +procedures, but symbolic representations of the functions that OpenGL +supports. +
+
Valid values for equation are: +
+
- add +
- subtract +
- reverse-subtract +
- min +
- max +
- alpha-min +
- alpha-max
+
Valid values for source-function are: +
+
- zero +
- one +
- destination-color +
- one-minus-destination-color +
- source-alpha-saturate +
- source-alpha +
- one-minus-source-alpha +
- destination-alpha +
- one-minus-destination-alpha +
- constant-color +
- one-minus-constant-color +
- constant-alpha +
- one-minus-constant-alpha +
+ +
Valid values for destination-function are: +
+
- zero +
- one +
- source-color +
- one-minus-source-color +
- source-alpha +
- one-minus-source-alpha +
- destination-alpha +
- one-minus-destination-alpha +
- constant-color +
- one-minus-constant-color +
- constant-alpha +
- one-minus-constant-alpha +
+ +
+ +
+
+
+Next: Framebuffers, Previous: 3D Models, Up: Graphics [Contents][Index]
+
diff --git a/manuals/chickadee/Buffers.html b/manuals/chickadee/Buffers.html index e5652c3..06b156a 100644 --- a/manuals/chickadee/Buffers.html +++ b/manuals/chickadee/Buffers.html @@ -85,7 +85,7 @@ ul.no-bullet {list-style: none} Next: Shaders, Previous: Rendering Engine, Up: Graphics [Contents][Index]

-
2.3.13 Buffers
+
2.3.14 Buffers

Alright, let’s brush aside all of those pretty high level abstractions and discuss what is going on under the hood. The GPU exists as a @@ -183,7 +183,7 @@ for each attribute.
With the vertex array created, the GPU is now fully aware of how to interpret the data that it has been given in the original buffer. Actually rendering this square is left as an exercise to the reader. -See the Shaders section and the gpu-apply procedure in +See the Shaders section and the shader-apply procedure in Rendering Engine for the remaining pieces of a successful draw call. Additionally, consider reading the source code for sprites, shapes, or particles to see GPU buffers in action. @@ -341,7 +341,7 @@ single number

divisor is only needed for instanced rendering applications (see -gpu-apply/instanced in Rendering Engine) and represents +shader-apply/instanced in Rendering Engine) and represents how many instances each vertex element applies to. A divisor of 0 means that a single element is used for every instance and is used for the data being instanced. A divisor of 1 means that each element is diff --git a/manuals/chickadee/Easings.html b/manuals/chickadee/Easings.html index 241e9e8..0e79a7e 100644 --- a/manuals/chickadee/Easings.html +++ b/manuals/chickadee/Easings.html @@ -85,7 +85,7 @@ ul.no-bullet {list-style: none} Next: Bezier Curves, Previous: Quaternions, Up: Math [Contents][Index]

2.2.7 Easings

2.2.6 Easings

Easing functions are essential for animation. Each easing function provides a different path to go from an initial value to a final diff --git a/manuals/chickadee/Fonts.html b/manuals/chickadee/Fonts.html index 4bc0411..e2ab386 100644 --- a/manuals/chickadee/Fonts.html +++ b/manuals/chickadee/Fonts.html @@ -32,8 +32,8 @@ http://www.texinfo.org/ (GNU Texinfo). - - + +