devilutionX/Source/utils/pcx_to_clx.hpp

#pragma once

#include <cstdint>
#include <optional>

#include <SDL.h>

#include "engine/assets.hpp"
#include "engine/clx_sprite.hpp"

namespace devilution {

/**
 * @brief Loads a PCX file as a CLX sprite.
 *
 * @param handle A non-null SDL_RWops handle. Closed by this function.
 * @param numFramesOrFrameHeight Pass a positive value with the number of frames, or the frame height as a negative value.
 * @param transparentColor The PCX palette index of the transparent color.
 */
OptionalOwnedClxSpriteList PcxToClx(AssetHandle &handle, size_t fileSize, int numFramesOrFrameHeight = 1, std::optional<uint8_t> transparentColor = std::nullopt, SDL_Color *outPalette = nullptr);

} // namespace devilution
Load PCX as CL2 Similar to #5059, which converted CEL to CL2 at load time, we now do the same for PCX. Some size stats: https://gist.github.com/glebm/067bf1ec73f9d14514932cfe237e4e8e Notably, fonts RAM usage is decreased by ~35%. 4 years ago			`#pragma once`

			`#include <cstdint>`
Remove utils/stdcompat/optional.hpp 3 years ago			`#include <optional>`
Load PCX as CL2 Similar to #5059, which converted CEL to CL2 at load time, we now do the same for PCX. Some size stats: https://gist.github.com/glebm/067bf1ec73f9d14514932cfe237e4e8e Notably, fonts RAM usage is decreased by ~35%. 4 years ago
Untangle more dependencies This allows us to make `clx_render_benchmark` and `text_render_integration_test` standalone. 8 months ago			`#include <SDL.h>`

Assets: Load files directly for UNPACKED_MPQS When using `UNPACKED_MPQS`, avoid all the SDL machinery for reading files. This is beneficial not only due to reduced indirection but also because we can test for the file's existence and get the file size without opening it, which is much faster. 3 years ago			`#include "engine/assets.hpp"`
CLX: A new graphics format The format is almost identical to CL2, except it uses the frame header to store frame width and height instead of 5 32-line offsets. This means we always have access to frame dimensions, so we can use it as an on-disk format for our graphics as well. Additionally, we may be able to optimize the rendering even more in the future now that we have guaranteed knowledge of frame dimensions. 4 years ago			`#include "engine/clx_sprite.hpp"`
Load PCX as CL2 Similar to #5059, which converted CEL to CL2 at load time, we now do the same for PCX. Some size stats: https://gist.github.com/glebm/067bf1ec73f9d14514932cfe237e4e8e Notably, fonts RAM usage is decreased by ~35%. 4 years ago
			`namespace devilution {`

Remove PCX rendering code We no longer render PCX 4 years ago			`/**`
CLX: A new graphics format The format is almost identical to CL2, except it uses the frame header to store frame width and height instead of 5 32-line offsets. This means we always have access to frame dimensions, so we can use it as an on-disk format for our graphics as well. Additionally, we may be able to optimize the rendering even more in the future now that we have guaranteed knowledge of frame dimensions. 4 years ago			`* @brief Loads a PCX file as a CLX sprite.`
Load PCX as CL2 Similar to #5059, which converted CEL to CL2 at load time, we now do the same for PCX. Some size stats: https://gist.github.com/glebm/067bf1ec73f9d14514932cfe237e4e8e Notably, fonts RAM usage is decreased by ~35%. 4 years ago			`*`
			`* @param handle A non-null SDL_RWops handle. Closed by this function.`
			`* @param numFramesOrFrameHeight Pass a positive value with the number of frames, or the frame height as a negative value.`
Add `SurfaceToClx` conversion function 4 years ago			`* @param transparentColor The PCX palette index of the transparent color.`
Load PCX as CL2 Similar to #5059, which converted CEL to CL2 at load time, we now do the same for PCX. Some size stats: https://gist.github.com/glebm/067bf1ec73f9d14514932cfe237e4e8e Notably, fonts RAM usage is decreased by ~35%. 4 years ago			`*/`
Assets: Load files directly for UNPACKED_MPQS When using `UNPACKED_MPQS`, avoid all the SDL machinery for reading files. This is beneficial not only due to reduced indirection but also because we can test for the file's existence and get the file size without opening it, which is much faster. 3 years ago			`OptionalOwnedClxSpriteList PcxToClx(AssetHandle &handle, size_t fileSize, int numFramesOrFrameHeight = 1, std::optional<uint8_t> transparentColor = std::nullopt, SDL_Color *outPalette = nullptr);`
Load PCX as CL2 Similar to #5059, which converted CEL to CL2 at load time, we now do the same for PCX. Some size stats: https://gist.github.com/glebm/067bf1ec73f9d14514932cfe237e4e8e Notably, fonts RAM usage is decreased by ~35%. 4 years ago
			`} // namespace devilution`