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 +- manuals/guile-sdl2/API-Reference.html | 57 +- manuals/guile-sdl2/Basics.html | 51 +- manuals/guile-sdl2/Blend-Modes.html | 203 +++++++ manuals/guile-sdl2/Chat.html | 33 +- manuals/guile-sdl2/Contributing.html | 39 +- manuals/guile-sdl2/Copying-This-Manual.html | 35 +- manuals/guile-sdl2/Events.html | 251 ++++---- manuals/guile-sdl2/Fonts.html | 120 +++- .../guile-sdl2/GNU-Free-Documentation-License.html | 46 +- manuals/guile-sdl2/Game-Controllers.html | 53 +- manuals/guile-sdl2/Getting-the-Source.html | 33 +- manuals/guile-sdl2/Hints.html | 116 ++++ manuals/guile-sdl2/Images.html | 41 +- manuals/guile-sdl2/Index.html | 641 +++++++++++---------- manuals/guile-sdl2/Input.html | 41 +- manuals/guile-sdl2/Installation.html | 35 +- manuals/guile-sdl2/Introduction.html | 37 +- manuals/guile-sdl2/Joysticks.html | 51 +- manuals/guile-sdl2/Keyboard.html | 37 +- manuals/guile-sdl2/Mouse.html | 41 +- manuals/guile-sdl2/OpenGL.html | 45 +- manuals/guile-sdl2/Rects.html | 63 +- manuals/guile-sdl2/Rendering.html | 205 +++++-- manuals/guile-sdl2/Requirements.html | 33 +- manuals/guile-sdl2/Sound.html | 99 ++-- manuals/guile-sdl2/Submitting-Patches.html | 33 +- manuals/guile-sdl2/Surfaces.html | 97 ++-- manuals/guile-sdl2/Window-Management.html | 37 +- manuals/guile-sdl2/Windows.html | 115 ++-- manuals/guile-sdl2/index.html | 105 ++-- 57 files changed, 2125 insertions(+), 1383 deletions(-) create mode 100644 manuals/chickadee/9_002dPatches.html create mode 100644 manuals/guile-sdl2/Blend-Modes.html create mode 100644 manuals/guile-sdl2/Hints.html (limited to 'manuals') 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). - + + + + + + + +
+

+Next: , Previous: , Up: Graphics   [Contents][Index]

+
+
+

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 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: , Previous: , 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: , Previous: , 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:

-

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: , Previous: , 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). - - + + + + + + + + +

+

+Next: , Previous: , Up: API Reference   [Contents][Index]

+
+
+

3.8 Blend Modes

+ +
+
(use-modules (sdl2 blend-mode))
+
+ +

SDL2 provides several of the most commonly used blend modes: +

+
+
Variable: none
+

No blending. +

+ +
+
Variable: blend
+

Alpha blending. +

+ +
+
Variable: add
+

Additive blending. +

+ +
+
Variable: mul
+

Multiplicative blending. +

+ +
+
Variable: mod
+

Color modulation. +

+ +

Custom blend modes can be created using the make-blend-mode +procedure. +

+
+
Procedure: make-blend-mode src-color-factor dst-color-factor color-operation src-alpha-factor dst-alpha-factor alpha-operation
+

Return a new custom blend mode for renderers. +

+

src-color-factor applies to the red, green, and blue components +of the source pixels. +

+

dst-color-factor applies to the red, green, and blue components of the +destination pixels. +

+

color-operation specifies how to combine the red, green, and blue +components of the source and destination pixels. +

+

src-alpha-factor applies to the alpha component of the source pixels. +

+

dst-alpha-factor applies to the alpha component of the destination +pixels. +

+

alpha-operation specifies how to combine the alpha component of the +source and destination pixels. +

+

Possible values for factors are zero, one, +src-color, one-minus-src-color, src-alpha, +one-minus-src-alpha, dst-color, +one-minus-dst-color, dst-alpha, and one-minus-dst +alpha. +

+

Possible values for operations are add, subtract, +rev-subtract, minimum, and maximum. +

+ +
+
Procedure: blend-mode? obj
+

Return #t if obj is a blend mode object. +

+ +
+
Procedure: blend-mode-src-color-factor blend-mode
+

Return the source red, green, and blue channel blend factor for +blend-mode. +

+ +
+
Procedure: blend-mode-dst-color-factor blend-mode
+

Return the destination red, green, and blue channel blend factor for +blend-mode. +

+ +
+
Procedure: blend-mode-color-operation blend-mode
+

Return the red, green, and blue channel blend operation for +blend-mode. +

+ +
+
Procedure: blend-mode-src-alpha-factor blend-mode
+

Return the source alpha channel blend factor for blend-mode. +

+ +
+
Procedure: blend-mode-dst-alpha-factor blend-mode
+

Return the destination alpha channel blend factor for +blend-mode. +

+ +
+
Procedure: blend-mode-alpha-operation blend-mode
+

Return the alpha channel blend operation for blend-mode. +

+ +
+
+

+Next: , Previous: , Up: API Reference   [Contents][Index]

+
+ + + + + diff --git a/manuals/guile-sdl2/Chat.html b/manuals/guile-sdl2/Chat.html index 1bd0642..434f53c 100644 --- a/manuals/guile-sdl2/Chat.html +++ b/manuals/guile-sdl2/Chat.html @@ -1,6 +1,6 @@ - - + Chat (Guile-SDL2) @@ -26,33 +28,24 @@ http://www.texinfo.org/ (GNU Texinfo). - - + + - - - + + + + + + + + + +
+

+Previous: , Up: API Reference   [Contents][Index]

+
+
+

3.12 Hints

+ +
+
(use-modules (sdl2 hints))
+
+ +
+
Procedure: get-hint hint
+

Get the string value of hint or #f if if hint is unset. +

+ +
+
Procedure: set-hint! hint value [priority]
+

Set hint to value at priority level priority. +priority can be one of the symbols default, normal or +override and defaults to normal. +value will automatically be converted to a string if it is a boolean +or a number. +

+ +

Inside SDL2, the macro SDL_HINT_SOME_HINT corresponds to the +environment variable SDL_SOME_HINT. In Guile-SDL2, this hint would be +represented by the symbol some-symbol. +

+ + + + + diff --git a/manuals/guile-sdl2/Images.html b/manuals/guile-sdl2/Images.html index 410d942..b4de67a 100644 --- a/manuals/guile-sdl2/Images.html +++ b/manuals/guile-sdl2/Images.html @@ -1,6 +1,6 @@ - - + Images (Guile-SDL2) @@ -26,33 +28,24 @@ http://www.texinfo.org/ (GNU Texinfo). - - + + - - - + + +