1
# SOME DESCRIPTIVE TITLE.
2
# Copyright (C) 2012, Tom Rothamel
3
# This file is distributed under the same license as the Ren'Py Visual Novel Engine package.
4
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
9
"Project-Id-Version: Ren'Py Visual Novel Engine 6.15.7\n"
10
"Report-Msgid-Bugs-To: \n"
11
"POT-Creation-Date: 2013-10-06 11:52\n"
12
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
13
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
14
"Language-Team: LANGUAGE <LL@li.org>\n"
16
"Content-Type: text/plain; charset=UTF-8\n"
17
"Content-Transfer-Encoding: 8bit\n"
19
#: ../../source/displayables.rst:7
20
# 6d459163484e4b189071d97d9dc50ac5
24
#: ../../source/displayables.rst:9
25
# 75fae97e051e4d53b01b4a21aeab5f92
26
msgid "A displayable is an object that can be shown to the user. Ren'Py displayables can be used in many ways."
29
#: ../../source/displayables.rst:12
30
# 2738686a830e4d1983db02728b9aa71b
31
msgid "Assignment to an image name using the image statement."
34
#: ../../source/displayables.rst:13
35
# 660ea95ca520473eac1e0fb6a44e15be
36
msgid "Added to a screen using the screen language add statement."
39
#: ../../source/displayables.rst:14
40
# c10acc69dc7f424ba7572768ab84e1ec
41
msgid "Assignment to certain config variables."
44
#: ../../source/displayables.rst:15
45
# 293a0dd6e149472283a66dbcac0f8796
46
msgid "Assignment to certain style properties."
49
#: ../../source/displayables.rst:17
50
# 1cd917c879d14bcca1543ab52d9e0b6d
51
msgid "When a Ren'Py function or variable expects a displayable, there are four things that can be provided:"
54
#: ../../source/displayables.rst:20
55
# 986ce0880e4a4d8fbca4d866d3130de0
56
msgid "An object of type Displayable, created by calling one of the functions given below."
59
#: ../../source/displayables.rst:22
60
# 467e5d1880fe4247993ed1b618b1a014
61
msgid "A string with a dot (.) in it. Such a string is interpreted as a filename by :func:`Image`."
64
#: ../../source/displayables.rst:24
65
# 3314c42fc7274158ae3ce4c599aacebe
66
msgid "A color. A color may either be given as a hexidecimal color string in \"#rgb\", \"#rgba\", \"#rrggbb\", or \"#rrggbbaa\" form, or an (r, g, b, a) tuple, where each component is an integer between 0 and 255. Colors are passed to :func:`Solid`."
69
#: ../../source/displayables.rst:28
70
# a36661ff02394540af3264776a028bf9
71
msgid "An image name. Any other string is interpreted as a reference to an image defined with the image statement."
74
#: ../../source/displayables.rst:34
75
# 5fb311d39772424ca154aa2fa6bf0073
79
#: ../../source/displayables.rst:36
80
# 5242a9fab77146a0aa45a141be19ad68
81
msgid "The most commonly used displayable is Image, which loads a file from disk and displays it. Since Image is so commonly used, when a string giving a filename is used in a context that expects a displayable, an Image is automatically created. The only time it's necessary to use Image directly is when you want to create an image with style properties."
84
#: ../../source/inc/im_image:5
85
# 970c415d5dc74ab7a3eef8adbd46a975
86
msgid "Loads an image from a file. `filename` is a string giving the name of the file."
89
#: ../../source/inc/im_image:8
90
# 62b051291dfb4cfbb33f2de10ad8f0c5
91
msgid "`filename` should be a JPEG or PNG file with an appropriate extension."
94
#: ../../source/displayables.rst:55
95
# 301c3ed5042247469c77d618966ade83
96
msgid "Loading an Image from from a file on disk and decoding it so it can be drawn to the screen takes a long amount of time. While measured in the tenths or hundreds of seconds, the duration of the loading process is long enough that it can prevent an acceptable framerate, and become annoying to the user."
99
#: ../../source/displayables.rst:61
100
# 7005f5ac4a40473a8bd9dc8bd0101f06
101
msgid "Since an Image is of a fixed size, and doesn't change in response to input, game state, or the size of the area available to it, an Image can be loaded before it is needed, and placed into an area of memory known as the image cache. Once an Image is decoded and in the cache, it can be quickly drawn to the screen."
104
#: ../../source/displayables.rst:67
105
# cd301cc2a2de48c2b291dd92909c8a21
106
msgid "Ren'Py attempts to predict the images that will be used in the future, and loads them into the image cache before they are used. When space in the cache is needed for other images, Ren'Py will remove images that are no longer being used."
109
#: ../../source/displayables.rst:72
110
# 38f73ad3f59f4d75b82657b79097ea29
111
msgid "By default, Ren'Py will predictively cache up to 8 screens worth of image data. (If your screen is 800x600, then a screen's worth of data is one 800x600 image, two 400x600 images, and so on.) This can be changed with the :var:config.image_cache_size configuration variable."
114
#: ../../source/displayables.rst:78
115
# fb09d3e3c1c4466c8fff0718777d90a8
116
msgid "Although the precise amount is dependent on implementation details and there is significant overhead, as a rule of thumb, each pixel in the image cache consumes 4 bytes of main memory and 4 bytes of video memory."
119
#: ../../source/displayables.rst:84
120
# 865b0333550b43f5a3e08a7ae635ddcf
121
msgid "Image-Like Displayables"
124
#: ../../source/displayables.rst:86
125
# a1015a73878a4c47b521df530b8c053f
126
msgid "We call these displayables image-like because they take up a rectangular area of the screen, and do not react to input. These differ from normal images by varying their size to fill an area (Frame, LiveTile, and Solid), or by allowing the user to specify their size (LiveComposite, LiveCrop, Null). They are not image manipulators."
129
#: ../../source/displayables.rst:92
130
# 74436405fe794bf1b19c166417dfe46a
131
msgid "Image-like displayables take :ref:`position-style-properties`."
134
#: ../../source/inc/disp_imagelike:5
135
# 12c7ae84ec684b6f90651d2db98dc3bd
136
msgid "This flattens `child`, which may be made up of multiple textures, into a single texture."
139
#: ../../source/inc/disp_imagelike:8
140
# cd49df0a142b44ee9490f5721b5595f4
141
msgid "Certain operations, like the alpha transform property, apply to every texture making up a displayable, which can yield incorrect results when the textures overlap on screen. Flatten creates a single texture from multiple textures, which can prevent this problem."
144
#: ../../source/inc/disp_imagelike:13
145
# 9d2ffb53c92944f28a5998a5d2ff01e7
146
msgid "Flatten is a relatively expensive operation, and so should only be used when absolutely required."
149
#: ../../source/inc/disp_imagelike:18
150
# 6467d68baaca41998e4b5fcf010751d1
151
msgid "A displayable that resizes an image to fill the available area, while preserving the width and height of its borders. is often used as the background of a window or button."
154
#: ../../source/inc/disp_imagelike:27
155
# 4604ef54968d4a2c8d89a42fa7707d10
159
#: ../../source/inc/disp_imagelike:27
160
# 03fa2a53b1434b18ae01d5f56caa76fa
161
msgid "An image manipulator that will be resized by this frame."
164
#: ../../source/inc/disp_imagelike:30
165
# bcce183e451f4838a0050bd6d096925f
169
#: ../../source/inc/disp_imagelike:30
170
# 4d9081e3be944b8eac76362e88654300
171
msgid "The size of the border on the left side."
174
#: ../../source/inc/disp_imagelike:33
175
# 577909889732426394b92b420f90c892
179
#: ../../source/inc/disp_imagelike:33
180
# 4af5a02b7b3245e5bc5bdb518265dfda
181
msgid "The size of the border on the top."
184
#: ../../source/inc/disp_imagelike:37
185
# d24798ecf31e4d608031b459d498d1eb
189
#: ../../source/inc/disp_imagelike:36
190
# 4010a92b15394d5abfbec60e5492797d
191
msgid "The size of the border on the right side. If None, defaults to `left`."
194
#: ../../source/inc/disp_imagelike:40
195
# 37ec8c6454674a28aa182333b4298cc0
199
#: ../../source/inc/disp_imagelike:40
200
# 870160877833403586b44b2dca8a0d7d
201
msgid "The side of the border on the bottom. If None, defaults to `top`."
204
#: ../../source/inc/disp_imagelike:44
205
# 1c67fa3afce3446ba8660e8d12440bf8
209
#: ../../source/inc/disp_imagelike:43
210
# 95fe9f734b0a4058a17ee78e7f0272e4
211
msgid "If true, tiling is used to resize sections of the image, rather than scaling."
214
#: ../../source/inc/disp_imagelike:55
215
# 3f2125caec874345b1f2d470397b28ba
216
msgid "This created a displayable by cropping `child` to `rect`, where `rect` is an (x, y, width, height) tuple. ::"
219
#: ../../source/inc/disp_imagelike:62
220
# 35c645eeb5a24e298a62f05d2661beba
221
msgid "Tiles `child` until it fills the area allocated to this displayable."
224
#: ../../source/inc/disp_imagelike:70
225
# b798fc30270442ce898056ae6725a791
226
msgid "A displayable that creates an empty box on the screen. The size of the box is controlled by `width` and `height`. This can be used when a displayable requires a child, but no child is suitable, or as a spacer inside a box."
229
#: ../../source/inc/disp_imagelike:81
230
# 4aff583c84cf4473a598921d0907a48c
231
msgid "A displayable that fills the area its assigned with `color`."
234
#: ../../source/displayables.rst:98
235
# c7526b2738c9421baba4f421d142b70d
236
msgid "Dynamic Displayables"
239
#: ../../source/displayables.rst:100
240
# 3b31c1cf1c134816a6c82a5485b68437
241
msgid "Dynamic displayables display a child displayable based on the state of the game. They do not take any properties, as layout is controlled by the properties of the child displayable they return."
244
#: ../../source/inc/disp_dynamic:5
245
# 2739d086de124598ad27672f02c2129e
246
msgid "This is a displayable that changes what it is showing based on python conditions. The positional argument should be given in groups of two, where each group consists of:"
249
#: ../../source/inc/disp_dynamic:9
250
# 990e98b76d014b4ca217501eb8777913
251
msgid "A string containing a python condition."
254
#: ../../source/inc/disp_dynamic:10
255
#: ../../source/inc/disp_dynamic:66
256
# 8a6f5251ffed4bbe820d125190781e4b
257
# 4aa0a087972d459ca331d116e5741193
258
msgid "A displayable to use if the condition is true."
261
#: ../../source/inc/disp_dynamic:12
262
# ee9308375de54e828bbc2bfd2167268c
263
msgid "The first true condition has its displayable shown, at least one condition should always be true."
266
#: ../../source/inc/disp_dynamic:23
267
# 9bd7164a1bde4d25b1e66914f44c3db4
268
msgid "A displayable that can change its child based on a Python function, over the course of an interaction."
271
#: ../../source/inc/disp_dynamic:40
272
# 58a9048ef8f64d47bc11ba335960dbe9
276
#: ../../source/inc/disp_dynamic:27
277
# 0dc0575613b54777a0a1a733ca0fb8a4
278
msgid "A function that is called with the arguments:"
281
#: ../../source/inc/disp_dynamic:29
282
# db9adcd0394b45b9a687f5978e954ea9
283
msgid "The amount of time the displayable has been shown for."
286
#: ../../source/inc/disp_dynamic:30
287
# 38d0a3336ae04d5e87a6fec2a772fc5e
288
msgid "The amount of time any displayable with the same tag has been shown for."
291
#: ../../source/inc/disp_dynamic:31
292
# 4d80f047152c49749a49e368f53417c5
293
msgid "Any positional or keyword arguments supplied to DynamicDisplayable."
296
#: ../../source/inc/disp_dynamic:33
297
# ae0fa675635d44979646b87f5f4daaad
298
msgid "and should return a (d, redraw) tuple, where:"
301
#: ../../source/inc/disp_dynamic:35
302
# 256468b5b5a74f1592846cb0f6384f71
303
msgid "`d` is a displayable to show."
306
#: ../../source/inc/disp_dynamic:36
307
# 05b9991178e24f3cba5a365c7aaa1d28
308
msgid "`redraw` is the amount of time to wait before calling the function again, or None to not call the function again before the start of the next interaction."
311
#: ../../source/inc/disp_dynamic:40
312
# 0edb8cbbbb39453aa09d5dc39159dec7
313
msgid "`function` is called at the start of every interaction."
316
#: ../../source/inc/disp_dynamic:42
317
# 61850c7e06c14478afc867bf0a8dfd3f
318
msgid "As a special case, `function` may also be a python string that evaluates to a displayable. In that case, function is run once per interaction."
321
#: ../../source/inc/disp_dynamic:61
322
# b228f892e3cf4858ac2f3ff72eda42d4
323
msgid "This is a displayable that changes what it is showing based on the images are showing on the screen. The positional argument should be given in groups of two, where each group consists of:"
326
#: ../../source/inc/disp_dynamic:65
327
# a7bf3ca27ccc4aff8fd314e262a8ec41
328
msgid "A string giving an image name, or None to indicate the default."
331
#: ../../source/inc/disp_dynamic:68
332
# c3db1a2793fc475491f9a1077f3fc35d
333
msgid "A default image should be specified."
336
#: ../../source/inc/disp_dynamic:70
337
# 28f21239d4b742b18c32034683d15294
338
msgid "One use of ShowingSwitch is to have side images change depending on the current emotion of a character. For example::"
341
#: ../../source/displayables.rst:108
342
# 12ff80f277134a0abf0933ced22dbfba
343
msgid "Applying Transforms to Displayables"
346
#: ../../source/displayables.rst:110
347
# 5cf4ce6396af405f9aa467bdbcca1706
348
msgid "The At function produces a displayable from a displayable and one or more :ref:`transforms <transforms>`."
351
#: ../../source/inc/disp_at:5
352
# d47b920dca5c45029021c44180df5b2f
353
msgid "Given a displayable `d`, applies each of the transforms in `args` to it. The transforms are applied in left-to-right order, so that the outermost transform is the rightmost argument. ::"
356
#: ../../source/displayables.rst:117
357
# 3d7acb950cb340e6a3de09b3efa5f8df
361
#: ../../source/displayables.rst:119
362
# b6e0d73a3fc248aa8be81d4ef83685b2
363
msgid "Layout boxes are displayables that lay out their children on the screen. They can lay out the children in a horizontal or vertical manner, or can lay them out using the standard positioning algorithm."
366
#: ../../source/displayables.rst:123
367
# 4a0da15fdee9476eba69f5e4347158d8
368
msgid "The box displayables take any number of positional and keyword arguments. Positional arguments should be displayables that are added to the box as children. Keyword arguments are style properties that are applied to the box."
371
#: ../../source/displayables.rst:128
372
# 5df7281280634f3082337c094b9bfbd3
373
msgid "Boxes take :ref:`position-style-properties` and :ref:`box-style-properties`."
376
#: ../../source/inc/disp_box:5
377
# f9894b52faea491d86b6eb0dc16d6e86
378
msgid "A box that fills the screen. Its members are laid out from back to front, with their position properties controlling their position."
381
#: ../../source/inc/disp_box:11
382
# 81c0d492822e4f499d5e4700b40dd9d7
383
msgid "A box that lays out its members from left to right."
386
#: ../../source/inc/disp_box:15
387
# e78abbe228c64a79a589147139c4c618
388
msgid "A layout that lays out its members from top to bottom."
391
#: ../../source/displayables.rst:149
392
# 53e14d8126ee4543a25d4ff23083011f
396
#: ../../source/displayables.rst:151
397
# b9d42a5190fd4f4bb236434b8d278ad8
398
msgid "These displayables are used to create certain visual effects."
401
#: ../../source/inc/disp_effects:5
402
# e41f26e348114523ac4b242d6103753c
403
msgid "This transition uses a `control` displayable (almost always some sort of animated transform) to transition from one displayable to another. The transform is evaluated. The `new` displayable is used where the transform is opaque, and the `old` displayable is used when it is transparent."
406
#: ../../source/inc/disp_effects:11
407
# 9bd1f80038014e8098d723c3e06d8822
411
#: ../../source/inc/disp_effects:11
412
# 23c7e12b29ae40d884a05a68bfa651da
413
msgid "If true, the image is composited with what's behind it. If false, the default, the image is opaque and overwrites what's behind it."
416
#: ../../source/displayables.rst:156
417
# 99eb97b3be844b0cb36d4f3da112b518
418
msgid "Image Manipulators"
421
#: ../../source/displayables.rst:158
422
# b5188f6fba68411da32e927dd0ff7a65
423
msgid "An image manipulator is a displayable that takes an image or image manipulator, performs an operation to it, and stores the result of that operation in the image cache. Since image manipulators can be predicted like images, they can perform expensive operations without incuring a display-time overhead."
426
#: ../../source/displayables.rst:164
427
# ebb8baaf479b4fa3bc73f26722a86799
428
msgid "Image manipulators are limited to storing image data to the cache. This means that their result is of a fixed size, known in advance, and they can't change in response to game state or input. Generally, image manipulators can only take images or other image manipulators as input."
431
#: ../../source/displayables.rst:170
432
# 9f23bbf610ba4742a09ed5e07d41447d
433
msgid "An image manipulator can be used any place a displayable can, but not vice-versa. An :func:`Image` is a kind of image manipulator, so an Image can be used whenever an image manipulator is required."
436
#: ../../source/displayables.rst:174
437
# 850e09398c90424788bb55d5d0b790bc
438
msgid "Many image manipulators provide the same functionality as other displayables. Most of these exist so they can be provided as input to other image manipulators, and so the game-maker can choose between cache memory usage and work done at render-time. There's also an element of historical accident here - many of these image manipulators predate their equivalents."
441
#: ../../source/inc/im_im:5
442
# f5d028bf81eb4bd7b013e94b6a203cbb
443
msgid "An image manipulator that takes two image manipulators, `base` and `mask`, as arguments. It replaces the alpha channel of `base` with the red channel of `mask`."
446
#: ../../source/inc/im_im:9
447
# d33d8f9fe61e45a0a6cee4952c21c4d8
448
msgid "This is used to provide an image's alpha channel in a second image, like having one jpeg for color data, and a second one for alpha. In some cases, two jpegs can be smaller than a single png file."
451
#: ../../source/inc/im_im:16
452
# 176c044f743c4ba4a01e6bdc4530c6df
453
msgid "This image manipulator composites multiple images together to form a single image."
456
#: ../../source/inc/im_im:19
457
# 71c1258d3df5499aad61394f295437e4
458
msgid "The `size` should be a (width, height) tuple giving the size of the composed image."
461
#: ../../source/inc/im_im:22
462
# 2310a955e3684fbd80a2be6352d72ead
463
msgid "The remaining positional arguments are interpreted as groups of two. The first argument in a group should be an (x, y) tuple, while the second should be an image manipulator. The image produced by the image manipulator is composited at the location given by the tuple."
466
#: ../../source/inc/im_im:39
467
# 47af021c62c2490aa0a6d7eaa15d3613
468
msgid "An image manipulator that crops `rect`, a (x, y, width, height) tuple, out of `im`, an image manipulator."
471
#: ../../source/inc/im_im:48
472
# d081067fdfec4f579720b58b07384b94
473
msgid "An image manipulator that scales `im` (a second image manipulator) to `width` times its original `width`, and `height` times its original height. If `height` is ommitted, it defaults to `width`."
476
#: ../../source/inc/im_im:52
477
#: ../../source/inc/im_im:79
478
# bd26b481500a4d7a8e0bc462c4fa89f2
479
# a54d8fd6097647c59512ef1683d7ddeb
480
msgid "If `bilinear` is true, then bilinear interpolation is used for the scaling. Otherwise, nearest neighbor interpolation is used."
483
#: ../../source/inc/im_im:61
484
# 792d6e92a1634b7fbefe04fa5a886d46
485
msgid "An image manipulator that flips `im` (an image manipulator) vertically or horizontally. `vertical` and `horizontal` control the directions in which the image is flipped."
488
#: ../../source/inc/im_im:71
489
# c3e5d61c58ac4b75936d24dcf529f756
490
msgid "An image manipulator that creats a desaturated version of the image manipulator `im`."
493
#: ../../source/inc/im_im:76
494
# db0ccd5bb0e54a77a494e4e5bb3a95ec
495
msgid "An image manipulator that scales `im` (an image manipulator) to `width` and `height`."
498
#: ../../source/inc/im_im:88
499
# 10a15b6e6f71462b9ef7db3e399256bc
500
msgid "An image manipulator that creates a sepia-toned version of the image manipulator `im`."
503
#: ../../source/inc/im_im:93
504
# 67d85dfe912243ea848666db25c2449e
505
msgid "An image manipulator that tiles the image manipulator `im`, until it is `size`."
508
#: ../../source/inc/im_im:97
509
# 822b536c3dac456cbe23a06b1ed7dc66
513
#: ../../source/inc/im_im:97
514
# 6c4d8706837f46fcbc6077b338cd6df5
515
msgid "If not None, a (width, height) tuple. If None, this defaults to (:var:`config.screen_width`, :var:`config.screen_height`)."
518
#: ../../source/displayables.rst:184
519
# 75883323b8df4a99b33d6a5dd0857367
520
msgid "im.MatrixColor"
523
#: ../../source/displayables.rst:186
524
# 733070994dba4e629b3e7d8dfc6a612d
525
msgid "The im.MatrixColor image manipulator is an image manipulator that uses a matrix to control how the colors of an image are transformed. The matrix used can be an im.matrix object, which encodes a 5x5 matrix in an object that supports matrix multiplication, and is returned by a series of functions. im.matrix objects may be multiplied together to yield a second object that performs both operations. For example, the code::"
528
#: ../../source/displayables.rst:198
529
# 85f2c7a2b3004ed5a349e631dc8f05da
530
msgid "first desaturates the image, and then tints it blue. When the intermediate image is not needed, multiplying matrices is far more efficient, in both time and image cache space, than using two im.MatrixColors."
533
#: ../../source/inc/im_matrixcolor:5
534
# 8e33f9fecdde4a3382a25d83a34fcdd4
535
msgid "An image operator that uses `matrix` to linearly transform the image manipulator `im`."
538
#: ../../source/inc/im_matrixcolor:8
539
# 28bd4f9ff6514d0780de8053958c308f
540
msgid "`Matrix` should be a list, tuple, or :func:`im.matrix` that is 20 or 25 elements long. If the object has 25 elements, then elements past the 20th are ignored."
543
#: ../../source/inc/im_matrixcolor:12
544
# 47c2f5b722d644be8288c9af8c1725f2
545
msgid "When the four components of the source color are R, G, B, and A, which range from 0.0 to 1.0; the four components of the transformed color are R', G', B', and A', with the same range; and the elements of the matrix are named::"
548
#: ../../source/inc/im_matrixcolor:22
549
# 49073b9d4a69428b88ad7c7cccc69ff2
550
msgid "the transformed colors can be computed with the formula::"
553
#: ../../source/inc/im_matrixcolor:29
554
# 09ceeb1612c3469e9aede1219f468801
555
msgid "The components of the transformed color are clamped to the range [0.0, 1.0]."
558
#: ../../source/inc/im_matrixcolor:34
559
# 6a302ffc62564271bab8b6375bc47316
560
msgid "Constructs an im.matrix object from `matrix`. im.matrix objects support The operations supported are matrix multiplication, scalar multiplication, element-wise addition, and element-wise subtraction. These operations are invoked using the standard mathematical operators (\\*, \\*, +, and -, respectively). If two im.matrix objects are multiplied, matrix multiplication is performed, otherwise scalar multiplication is used."
563
#: ../../source/inc/im_matrixcolor:42
564
# 7f543e1868234faca718bf3d8330291c
565
msgid "`matrix` is a 20 or 25 element list or tuple. If it is 20 elements long, it is padded with (0, 0, 0, 0, 1) to make a 5x5 matrix, suitable for multiplication."
568
#: ../../source/inc/im_matrixcolor:48
569
# d0024c5403484af58089d396a4c17f77
570
msgid "Returns an im.matrix that alters the brightness of an image."
573
#: ../../source/inc/im_matrixcolor:52
574
# 8a6906023d9741faaf073c470b54764f
578
#: ../../source/inc/im_matrixcolor:51
579
# 4137c26296d74dff9b4c99ba640b57ae
580
msgid "The amount of change in image brightness. This should be a number between -1 and 1, with -1 the darkest possible image and 1 the brightest."
583
#: ../../source/inc/im_matrixcolor:57
584
# 8a409e86e25a4ed0806afbcbfd98d0b9
585
msgid "Returns an im.matrix that colorizes a black and white image. `black_color` and `white_color` are Ren'Py style colors, so they may be specfied as strings or tuples of (0-255) color values. ::"
588
#: ../../source/inc/im_matrixcolor:69
589
# b79afd0ac80a40d883f91f045b4bbff4
590
msgid "Returns an im.matrix that alters the contrast of an image. `c` should be greater than 0.0, with values between 0.0 and 1.0 decreasing contrast, and values greater than 1.0 increasing contrast."
593
#: ../../source/inc/im_matrixcolor:75
594
# 70296780d13e42af86b833c7ea002ac7
595
msgid "Returns an im.matrix that desaturates the image (makes it grayscale). This is equivalent to calling im.matrix.saturation(0)."
598
#: ../../source/inc/im_matrixcolor:81
599
# 54038df59b454883a709e85d735867bf
600
msgid "Returns an im.matrix that rotates the hue by `h` degrees, while preserving luminosity."
603
#: ../../source/inc/im_matrixcolor:86
604
# 56a7f8bed7024e10bfa72216767f8df7
605
msgid "Returns an identity matrix, one that does not change color or alpha."
608
#: ../../source/inc/im_matrixcolor:91
609
# b3b4ead6626a43cf9a39bd5ee5f39d80
610
msgid "Returns an im.matrix that inverts the red, green, and blue channels of the image without changing the alpha channel."
613
#: ../../source/inc/im_matrixcolor:96
614
# 2d95c0a5c2c1412486406e4bdb558a0b
615
msgid "Returns an im.matrix that alters the opacity of an image. An `o` of 0.0 is fully transparent, while 1.0 is fully opaque."
618
#: ../../source/inc/im_matrixcolor:101
619
# 5803e282595c4b17b65c244476aaf8cb
620
msgid "Returns an im.matrix that alters the saturation of an image. The alpha channel is untouched."
623
#: ../../source/inc/im_matrixcolor:106
624
# e25be39e8a044db6ac51576c534fda76
628
#: ../../source/inc/im_matrixcolor:105
629
# 5f27e3b182a046afae3de4a0f127c32b
630
msgid "The amount of saturation in the resulting image. 1.0 is the unaltered image, while 0.0 is grayscale."
633
#: ../../source/inc/im_matrixcolor:114
634
# d861af6f48dd44e2a9930a8a0135722e
638
#: ../../source/inc/im_matrixcolor:109
639
# a6e68d9481394d7abf1c6340c96353e0
640
msgid "This is a 3-element tuple that controls how much of the red, green, and blue channels will be placed into all three channels of a fully desaturated image. The default is based on the constants used for the luminance channel of an NTSC television signal. Since the human eye is mostly sensitive to green, more of the green channel is kept then the other two channels."
643
#: ../../source/inc/im_matrixcolor:119
644
# 86f24e2950e24cdbaa5bff8d313ab197
645
msgid "Returns an im.matrix that tints an image, without changing the alpha channel. `r`, `g`, and `b` should be numbers between 0 and 1, and control what fraction of the given channel is placed into the final image. (For example, if `r` is .5, and the value of the red channel is 100, the transformed color will have a red value of 50.)"