diff options
Diffstat (limited to 'manuals/chickadee/9_002dPatches.html')
-rw-r--r-- | manuals/chickadee/9_002dPatches.html | 131 |
1 files changed, 131 insertions, 0 deletions
diff --git a/manuals/chickadee/9_002dPatches.html b/manuals/chickadee/9_002dPatches.html new file mode 100644 index 0000000..270ee0e --- /dev/null +++ b/manuals/chickadee/9_002dPatches.html @@ -0,0 +1,131 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<html> +<!-- Copyright (C) 2017-2020 David Thompson davet@gnu.org + +Permission is granted to copy, distribute and/or modify this document +under the terms of the GNU Free Documentation License, Version 1.3 +or any later version published by the Free Software Foundation; +with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. +A copy of the license is included in the section entitled "GNU +Free Documentation License". + +A copy of the license is also available from the Free Software +Foundation Web site at http://www.gnu.org/licenses/fdl.html. + + +* Chickadee: (chickadee). Game programming toolkit for Guile. + +The document was typeset with +http://www.texinfo.org/ (GNU Texinfo). + --> +<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<title>9-Patches (The Chickadee Game Toolkit)</title> + +<meta name="description" content="9-Patches (The Chickadee Game Toolkit)"> +<meta name="keywords" content="9-Patches (The Chickadee Game Toolkit)"> +<meta name="resource-type" content="document"> +<meta name="distribution" content="global"> +<meta name="Generator" content="makeinfo"> +<link href="index.html" rel="start" title="Top"> +<link href="Index.html" rel="index" title="Index"> +<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents"> +<link href="Graphics.html" rel="up" title="Graphics"> +<link href="Fonts.html" rel="next" title="Fonts"> +<link href="Sprites.html" rel="prev" title="Sprites"> +<style type="text/css"> +<!-- +a.summary-letter {text-decoration: none} +blockquote.indentedblock {margin-right: 0em} +div.display {margin-left: 3.2em} +div.example {margin-left: 3.2em} +div.lisp {margin-left: 3.2em} +kbd {font-style: oblique} +pre.display {font-family: inherit} +pre.format {font-family: inherit} +pre.menu-comment {font-family: serif} +pre.menu-preformatted {font-family: serif} +span.nolinebreak {white-space: nowrap} +span.roman {font-family: initial; font-weight: normal} +span.sansserif {font-family: sans-serif; font-weight: normal} +ul.no-bullet {list-style: none} +@media (min-width: 1140px) { + body { + margin-left: 14rem; + margin-right: 4rem; + max-width: 52rem; + } +} + +@media (min-width: 800px) and (max-width: 1140px) { + body { + margin-left: 6rem; + margin-right: 4rem; + max-width: 52rem; + } +} + +@media (max-width: 800px) { + body { + margin: 1rem; + } +} + +--> +</style> +<link rel="stylesheet" type="text/css" href="https://dthompson.us/css/dthompson.css"> + + +</head> + +<body lang="en"> +<span id="g_t9_002dPatches"></span><div class="header"> +<p> +Next: <a href="Fonts.html" accesskey="n" rel="next">Fonts</a>, Previous: <a href="Sprites.html" accesskey="p" rel="prev">Sprites</a>, Up: <a href="Graphics.html" accesskey="u" rel="up">Graphics</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html" title="Index" rel="index">Index</a>]</p> +</div> +<hr> +<span id="g_t9_002dPatches-1"></span><h4 class="subsection">2.3.4 9-Patches</h4> + +<p>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: +</p> +<ul> +<li> the center, which can be stretched or tiled horizontally and vertically +</li><li> the four corners, which are never stretched or tiled +</li><li> the left and right sides, which can be stretched or tiled vertically +</li><li> the top and bottom sides, which can be stretched or tiled horizontally +</li></ul> + +<p>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. +</p> +<dl> +<dt id="index-draw_002dnine_002dpatch">Procedure: <strong>draw-nine-patch</strong> <em>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]</em></dt> +<dd> +<p>Draw a 9-patch over the area <var>rect</var> using <var>texture</var> 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. +</p> +<p><var>mode</var> may be either <code>stretch</code> (the default) or <code>tile</code>. +</p> +<p><var>margin</var> specifies the margin size for all sides of the 9-patch. +To make margins of differing sizes, the <var>top-margin</var>, +<var>bottom-margin</var>, <var>left-margin</var>, and <var>right-margin</var> +arguments may be used. +</p> +<p>Refer to <code>draw-sprite</code> (see <a href="Sprites.html">Sprites</a>) for information about +the other arguments as they are the same. +</p></dd></dl> + + + + +</body> +</html> |