Get your 3D pixel painting in minecraft. 在minecraft中生成3d的地图画
SlopeCraft软件是我（TokiNoBug）用qt+Eigen+zlib开发的、用于在minecraft中生成立体地图画的软件。
与spritecraft等像素画软件不同，SlopeCraft是专门面向地图的像素画，它设计的目的就是让你用地图将像素画记录下来，然后贴在物品展示框上。这里地图指游戏中可以记录地形的物品，不是存档。
所以，SlopeCraft的颜色调整模块是完全面向地图的，它不是为了让像素画在玩家视角中接近原图，而是为了让像素画在地图的“视角”中接近原图。
由于地图中的颜色与方块的相对高度有关，所以SlopeCraft生存的地图画往往不是平板的，而是立体的，是人工地形。我将其称为立体地图画。
一言以蔽之，SlopeCraft是为地图而设计的。
正是因此，利用SlopeCraft制作的地图画的“画质”，比spritecraft导出、再用地图记录的地图画要好很多——因为专业。<
SlopeCraft is created by me(TokiNoBug) using qt+Eigen+zlib - it's used to create 3D pixel map arts within Minecraft.
The difference between this program and SpriteCraft is that this program focuses on pixel art on maps. Its purpose is to record the pixel art with the map, then display it in an item frame (the map here refers to the in-game item, and not the save file).
The color modification module is targeted towards the map. The pixel art is meant to resemble the art within a map - it will not resemble the art from the point of view of the player.
Since the color within the map is related to the relative height of the block, the pixel art created by SlopeCraft is usually in 3D, which I call 3D Pixel Art.
In summary, SlopeCraft is created for map pixel art.
This is why maps made by SlopeCraft have higher quality than exporting a picture from SpriteCraft then recording it with a map - because SlopeCraft is specifically designed for map pixel art.
在SlopeCraft中，你可以调节地图画所对应的游戏版本、地图画类型、颜色空间和方块列表。我将一一简述这些参数是怎么回事。
SlopeCraft支持的minecraft版本为1.12~1.16。其中从1.12到1.15的地图没有什么变化，最多只有204种颜色；而1.16则为了下界树木增加了28种颜色，达到了232色。（这里的颜色忽略透明）
Creative类型的地图画可以使用到完整的204/232种颜色，享受最高的画质；但它不能导出为立体地图画，只能导出为地图文件，利用作弊的方法在存档中呈现。
关于这种方法，可以使用 mc-map.djfun.de 这个网站。
Survival类型的地图画则牺牲了1/4的颜色，换来可以在原版生存实装的优点。这种地图画可以生成为三维地图画，也是这个软件的核心功能。
Flat类型的地图画是平板的。由于立体地图画实装的难度很高，我特意开发了平板地图画的功能。
平板地图画顾名思义，是传统平坦的像素画，它最容易实装，但只有Creative类型1/4的颜色：51/58色。
这里需要注明，Survival类型与Creative类型冲突，地图画只能为其中一种；但Flat类型的地图画与它们平行（虽然平坦的Creative没什么意义）。
这是比较专业的部分。简单来说不同的颜色空间是用不同的方式去描述颜色。在SlopeCraft中，它代表着不同的调整颜色的方式。
SlopeCraft中使用了4种颜色空间：RGB、HSV、Lab、XYZ。
其中Lab模式对大多数图片的调整效果最好，我将它设为默认。但具体到每个像素画，你最好依次尝试一下，选择视觉效果最好的调整方案。
这是最为重要的部分，它与最终生成的地图画息息相关。简单来说，地图中的每个基础颜色往往对应着多种方块，但导出的时候我们只能给每个基础颜色选择一种对应的方块。
所以方块列表就是建造像素画的“材料表”，称之为方块列表。我预设了4种方块列表，分别为：Vanilla，Cheap，Elegant和Shiny。
Vanilla方块列表尽量还原每一种基础颜色的“原汁原味”，如沙子的颜色就对应砂岩、钻石块的颜色就对应钻石块等。 它往往不太适合生存实装（废话，3000个钻石块爽死你），只适合创造模式演示，因此我命名为Creative。
Cheap是极度优化的方块列表，一切基础颜色都尽全力选择生存中最容易获得的、最廉价的方块，比如“下界”的颜色使用地狱岩、“白色”使用雪块。它适合生存的早期和中期。
Elegent是“最优雅”的方块列表，它尽量选择了生存中可以量产，又“足够优雅”的方块，如“白色”使用白色混凝土。它适合生存的后期，是首选，也是默认。
Shiny专为光影而生，它尽量选择可以发光的方块。
Custom是自定义的方块列表，你可以自由的配置一切。
1.Game Version: SlopeCraft supports 1.12 to 1.16. There isn't much difference from 1.12 to 1.15, but the addition of nether trees added 28 more colors, creating a total of 232 colors (ignoring transparent blocks).
Creative Map Art uses the full color palette. It has the highest quality, but it can't be exported into the world itself. It can only be exported as a map file, using commands to obtain it in game.
For more information on this procedure, visit mc-map.djfun.de
Survival Map Art leaves 1/4th of the colors out as a trade off for being able to export it into vanilla survival. This type of map art can generate 3D map arts, which is the core feature of this program.
Flat type Map Art is the traditional 2D map art - it's the easiest to build but it only have 1/4th of the color palette compared to Creative: 51/58 colors.
Do note, Survival and Creative map arts are mutually exclusive - the map art can only be one of the two types, but Flat type map art can be used on both of them (Having a flat Creative Map Art is pointless though)
This is more difficult to explain. Simply put, the program describes the color in different ways in each color space. In SlopeCraft, this means different ways of choosing a block for a color
The four types of color space: RGB, HSV, LAB, XYZ
Lab is the best quality for most pictures, which is why it is default, but the others should still be tried to see which color space has the best visual effect for your picture.
This is the most important part, it controls how the final product looks. Simply put, every color within a picture has multiple blocks with its color, but we can only choose one when we export it, which means only one block of each color can be chosen
So the Block List is more like the Material List of the pixel art. 4 Presets have been set: Vanilla, Cheap, Elegant and Shiny.
Vanilla block lists try to recreate the color of the original picture as much as possible, such as the color of sand being sandstone, the color of diamond blocks will use diamond blocks. This preset is usually not used within survival (have fun trying to get 3000 Diamond Blocks), but for creative mode purposes, which is why I call it Creative.
Cheap is a highly optimized block list - every color will use its most easily obtainable block counterpart. The color red would use netherrack, the color white would use snow. This is best for survival mode when resources aren't abundant.
Elegant: The most "Elegant" Block List, it mostly uses blocks that can be mass produced in survival while still looking clean, such as white being white concrete. It's best for late stages of survival, when resources are abundant.
Shiny is created specifically for use with shaders, so it mostly uses blocks that emits light.
Custom is for you to freely choose the blocks you would like to use.
SlopeCraft包含以下功能：
导入图片、调整颜色、生成立体地图画、导出为投影文件。
These features are included in SlopeCraft
Importing Pictures, Adjusting Colors, Generating 3D map art, exporting into a file for Minecraft
无需安装。
No Installation Required
- 准备好你要转换的图片。最好事先用ps等编辑图片的软件（甚至是画图也可以）将图片裁剪、缩放，使图片的长和宽均为128像素的整数倍，这样最适合mc中的地图
- 打开SlopeCraft.exe，在开始界面选择地图画的类别。
- 点击 导入图片 按钮，选择你裁剪后的图片，程序会将这个图片导入。
- 选择适当的游戏版本地图画类型，点击确认后，点击下一页。
- 在方块列表页面中配置这幅地图画的方块列表。一般情况下你可以什么都不做，只点击确认，然后进入下一页。
- 在调整颜色页面，选择任何一种颜色空间，点击调整颜色。完成这一步之后，点击导出为投影。（另外两个导出选项还没有完成）
- 在导出为投影页面，设置投影名称、投影作者和投影区域名称。（你也可以不填）。然后先点击构建三维结构，待进度条完成后，点击导出为投影。导出完毕后，点击完成按钮。
- 点击左下角的查看导出的文件按钮，或点击右下角的退出按钮，结束程序。
- Find the picture you would like to turn into a pixel art. Use Photoshop or other photo editing softwares to make sure the length and width of the picture in pixels are multiples of 128, which is best for maps in Minecraft.
- Open SlopeCraft.exe, and choose the type of map art you would like to create in the start menu.
- Click the "Import Photo" button, and choose the modified photo from step 1. The program will then import it.
- Choose the right game version for your map art, click Confirm, and click Next Page.
- Choose the block list for your map art - usually you can skip this step and just choose Confirm.
- In the color adjusting page, choose any color space, choose Convert to Map, then click one of the export options.
- In the Export page (different for each export option), follow the instructions in the page.