devilutionX/Source/utils/surface_to_pcx.cpp

#include "utils/surface_to_pcx.hpp"

#include <cerrno>
#include <cstdint>
#include <cstdio>
#include <cstring>
#include <string>

#ifdef USE_SDL3
#include <SDL3/SDL_error.h>
#include <SDL3/SDL_iostream.h>
#else
#include <SDL.h>
#endif

#include <expected.hpp>

#include "engine/surface.hpp"
#include "utils/endian_swap.hpp"
#include "utils/pcx.hpp"

namespace devilution {
namespace {

tl::expected<void, std::string> CheckedFWrite(const void *ptr, size_t size,
#ifdef USE_SDL3
    SDL_IOStream *
#else
    SDL_RWops *
#endif
        out)
{
#ifdef USE_SDL3
	if (SDL_WriteIO(out, ptr, size) != size)
#else
	if (SDL_RWwrite(out, ptr, size, 1) != 1)
#endif
	{
		const char *errorMessage = SDL_GetError();
		if (errorMessage == nullptr)
			errorMessage = "";
		tl::expected<void, std::string> result = tl::make_unexpected(std::string("write failed with: ").append(errorMessage));
		SDL_ClearError();
		return result;
	}
	return {};
}

/**
 * @brief Write the PCX-file header
 * @param width Image width
 * @param height Image height
 * @param out File stream to write to
 * @return True on success
 */
tl::expected<void, std::string> WritePcxHeader(int16_t width, int16_t height,
#ifdef USE_SDL3
    SDL_IOStream *
#else
    SDL_RWops *
#endif
        out)
{
	PCXHeader buffer;

	memset(&buffer, 0, sizeof(buffer));
	buffer.Manufacturer = 10;
	buffer.Version = 5;
	buffer.Encoding = 1;
	buffer.BitsPerPixel = 8;
	buffer.Xmax = Swap16LE(width - 1);
	buffer.Ymax = Swap16LE(height - 1);
	buffer.HDpi = Swap16LE(width);
	buffer.VDpi = Swap16LE(height);
	buffer.NPlanes = 1;
	buffer.BytesPerLine = Swap16LE(width);

	return CheckedFWrite(&buffer, sizeof(buffer), out);
}

/**
 * @brief Write the current in-game palette to the PCX file
 * @param palette Current palette
 * @param out File stream for the PCX file.
 * @return True if successful, else false
 */
tl::expected<void, std::string> WritePcxPalette(SDL_Color *palette,
#ifdef USE_SDL3
    SDL_IOStream *
#else
    SDL_RWops *
#endif
        out)
{
	uint8_t pcxPalette[1 + 256 * 3];

	pcxPalette[0] = 12;
	for (int i = 0; i < 256; i++) {
		pcxPalette[1 + 3 * i + 0] = palette[i].r;
		pcxPalette[1 + 3 * i + 1] = palette[i].g;
		pcxPalette[1 + 3 * i + 2] = palette[i].b;
	}

	return CheckedFWrite(pcxPalette, sizeof(pcxPalette), out);
}

/**
 * @brief RLE compress the pixel data
 * @param src Raw pixel buffer
 * @param dst Output buffer
 * @param width Width of pixel buffer

 * @return Output buffer
 */
uint8_t *WritePcxLine(uint8_t *src, uint8_t *dst, int width)
{
	int rleLength;

	do {
		const uint8_t rlePixel = *src;
		src++;
		rleLength = 1;

		width--;

		while (rlePixel == *src) {
			if (rleLength >= 63)
				break;
			if (width == 0)
				break;
			rleLength++;

			width--;
			src++;
		}

		if (rleLength > 1 || rlePixel > 0xBF) {
			*dst = rleLength | 0xC0;
			dst++;
		}

		*dst = rlePixel;
		dst++;
	} while (width > 0);

	return dst;
}

/**
 * @brief Write the pixel data to the PCX file
 *
 * @param buf Pixel data
 * @param out File stream for the PCX file.
 * @return True if successful, else false
 */
tl::expected<void, std::string> WritePcxPixels(const Surface &buf,
#ifdef USE_SDL3
    SDL_IOStream *
#else
    SDL_RWops *
#endif
        out)
{
	const int width = buf.w();
	const std::unique_ptr<uint8_t[]> pBuffer { new uint8_t[static_cast<size_t>(2 * width)] };
	uint8_t *pixels = buf.begin();
	for (int height = buf.h(); height > 0; height--) {
		const uint8_t *pBufferEnd = WritePcxLine(pixels, pBuffer.get(), width);
		pixels += buf.pitch();
		tl::expected<void, std::string> result = CheckedFWrite(pBuffer.get(), pBufferEnd - pBuffer.get(), out);
		if (!result.has_value()) return result;
	}
	return {};
}

} // namespace

tl::expected<void, std::string>
WriteSurfaceToFilePcx(const Surface &buf,
#ifdef USE_SDL3
    SDL_IOStream *
#else
    SDL_RWops *
#endif
        outStream)
{
	tl::expected<void, std::string> result = WritePcxHeader(buf.w(), buf.h(), outStream);
	if (!result.has_value()) return result;
	result = WritePcxPixels(buf, outStream);
	if (!result.has_value()) return result;
	result = WritePcxPalette(buf.surface->format->palette->colors, outStream);
	if (!result.has_value()) return result;
#ifdef USE_SDL3
	SDL_CloseIO(outStream);
#else
	SDL_RWclose(outStream);
#endif
	return {};
}

} // namespace devilution