Function ParseCompanyManagerFaceCode

src/company_cmd.cpp:1490–1525

* Parse a face code into a company manager face. * @param str Face code to parse. * @return Company manager face, or std::nullopt if it could not be parsed. */

 * @return Company manager face, or std::nullopt if it could not be parsed.
 */
std::optional<CompanyManagerFace> ParseCompanyManagerFaceCode(std::string_view str)
{
	if (str.empty()) return std::nullopt;

	CompanyManagerFace cmf;
	StringConsumer consumer{str};
	if (consumer.FindChar(':') != StringConsumer::npos) {
		auto label = consumer.ReadUntilChar(':', StringConsumer::SKIP_ONE_SEPARATOR);

		/* Read numeric part and ensure it's valid. */
		auto bits = consumer.TryReadIntegerBase<uint32_t>(10, true);
		if (!bits.has_value() || consumer.AnyBytesLeft()) return std::nullopt;

		/* Ensure style label is valid. */
		auto style = FindCompanyManagerFaceLabel(label);
		if (!style.has_value()) return std::nullopt;

		SetCompanyManagerFaceStyle(cmf, *style);
		cmf.bits = *bits;
	} else {
		/* No ':' included, treat as numeric-only. This allows old-style codes to be entered. */
		auto bits = ParseInteger(str, 10, true);
		if (!bits.has_value()) return std::nullopt;

		/* Old codes use bits 0..1 to represent face style. These map directly to the default face styles. */
		SetCompanyManagerFaceStyle(cmf, GB(*bits, 0, 2));
		cmf.bits = *bits;
	}

	/* Force the face bits to be valid. */
	FaceVars vars = GetCompanyManagerFaceVars(cmf.style);
	ScaleAllCompanyManagerFaceBits(cmf, vars);
	cmf.bits = MaskCompanyManagerFaceBits(cmf, vars);

	return cmf;
}