Cardset Customization Tutorial ============================== :Author: Eric Rausch :Email: config.txt template ------------------- .... PySolFC solitaire cardset;$A;$FMT;$B;$C;$D,$E;$F;$G;$H ; X Y D XOFF YOFF SXOFF SYOFF back01.ext back01.ext;back02.ext;back03.ext .... Line 1 ------ *$A:* The cardset version number that belongs to the number of fields divided through ";" on the first line (e.g. `.gif;1;78;8,1016` -> `$A=4`) ( *WARNING:* For Mahjongg, $A must always be 6 or 7 and the $F field must be included in the line; however, you can put `0` in `$F` if you wish, in that case. ) ( *NOTE:* $D and $E are comma separated and count for one field ) *$FMT:* The format of the images used - .gif, .png, .jpg, .ppm, and .bmp are supported *$B:* The type of the cardset (see types below) Cardsets Types: ~~~~~~~~~~~~~~~ * French = 1 * Hanafuda = 2 * Tarock = 3 * Mahjongg = 4 * Hex A Deck = 5 * Mughal Ganjifa = 6 * Navagraha Ganjiga = 7 * Dashavatara Ganjifa = 8 * Trumps Only = 9 * Matching = 10 *$C:* The number of cards in the cardset, generally 42, 48, 52, 68, 78, 96 or 120 *$D:* The Style of the cardset (this field can hold one or more comma separated values) Cardsets Styles: ~~~~~~~~~~~~~~~~ * Adult = 1 * Animals = 2 * Anime = 3 * Art = 4 * Cartoons = 5 * Children = 6 * Classic Look = 7 * Collectors = 8 * Computers = 9 * Engines = 10 * Fantasy = 11 * Ganjifa= 30 * Hanafuda = 12 * Hex A Deck = 29 * Holiday = 13 * Mahjongg = 28 * Matching = 32 * Movies = 14 * Matrix = 31 * Music = 15 * Nature = 16 * Operating Systems = 17 * People = 19 * Places = 20 * Plain = 21 * Products = 22 * Round Cardsets = 18 * Science Fiction = 23 * Sports = 24 * Tarock = 27 * Vehicles = 25 * Video Games = 26 *$E:* The origin (country) of the cardset Cardsets Origins: ~~~~~~~~~~~~~~~~~ * Australia = 1021 * Austria = 1001 * Belgium = 1019 * Canada = 1010 * China = 1011 * Czech Republic = 1012 * Denmark = 1013 * England = 1003 * France = 1004 * Germany = 1006 * Great Britain = 1014 * Hungary = 1015 * India = 1020 * Italy = 1005 * Japan = 1016 * Netherlands = 1002 * Russia = 1007 * Spain = 1008 * Sweden = 1017 * Switzerland = 1009 * USA = 1018 *$F:* The Year the cardset was created (in the range 1000 to 2299) *$G:* The subtype of the cardset. Usually 0 - for French type cardsets, a value of 1 is used if there are jokers. *$H:* Whether the cardset is a 3D Mahjongg cardset - 1 if it is, 0 if it isn't. For cardsets with a version less than 7, version 6 cardsets treat this value as 1, and older version cardsets treat it as 0. Line 2 ------ ``: A name for PySolFC to identify your cardset (without spaces) ( *TIP:* You could add a number prefix (e.g. 123-cardset-name) ) ``: Your cardset name as it should appear in the cardset manager Line 3 ------ * *X:* The cards width (the card image width) * *Y:* The cards height (the card image height) * *D:* The color depth (mostly 8) Line 4 ------ * *XOFF:* The horizontal offset of the cards * *YOFF:* The vertical offset of the cards * *SXOFF:* The offset of the horizontal shadow (mostly 7) * *SYOFF:* The offset of the vertical shadow (mostly 7) Line 5 ------ `back01.ext`: The name of the default back image (where `ext` means the file extension e.g: `png` or `gif`.) Line 6 ------ `back01.ext;back02.ext;back03.ext;…``: The name of the other back images, including the default one. About this document: -------------------- *NOTE:* This tutorial may be incomplete. It is given as is, without any warranty, to help players customize their own cardsets. You are welcome to send any suggestions to: mailto:neelix570@gmail.com[the Author's E-mail], https://github.com/shlomif/PySolFC/issues[PySol FC's GitHub issue tracker] or https://sourceforge.net/p/pysolfc/_list/tickets[PySol FC's Sourceforge issue tracker]. *NOTE 2:* You should also place a file called `COPYRIGHT` in the same directory as `config.txt`, containing the text that can be accessed via `Info/Settings`. License: ~~~~~~~~ This tutorial was created under the terms of the GNU General Public License version 3 or later. You can redistribute it as is and/or modify it. Shlomi Fish, hereby puts his modifications to this document under https://github.com/shlomif/shlomif-computer-settings/blob/master/shlomif-settings/git/commit-messages/cc0-copyright-disclaimer.txt[CC0 / Public Domain / MIT License / GPL terms] Credits: ~~~~~~~~ Credits go to: mailto:andsa@web.de[Andreas Sauer] for clarifying certain points + https://www.shlomifish.org/[Shlomi Fish] for making some improvements to this tutorial