/*
 * libptouch.h — public C API
 *
 * Author: knb
 * Email: knb@artif.org
 */

/**
 * libptouch — Brother P-touch ラスター印刷 (USB) 用 C API
 *
 * 対象例: PT-P900W（560 ドットヘッド）、PT-P750W / PT-P710BT（128 ドットヘッド）。
 * 実装は src/lib/libptouch_*.c を参照。
 */

#ifndef LIBPTOUCH_H
#define LIBPTOUCH_H

#include "libptouch_version.h"

#include <stddef.h>
#include <stdint.h>
#include <stdio.h>

#ifdef __cplusplus
extern "C" {
#endif

/** 不透明コンテキスト（接続状態・最終エラー文字列を保持） */
typedef struct libptouch_ctx libptouch_ctx;

typedef enum {
	LIBPTOUCH_OK = 0,
	LIBPTOUCH_ERR_NOMEM = 1,
	LIBPTOUCH_ERR_ARG = 2,
	LIBPTOUCH_ERR_USB = 3,
	LIBPTOUCH_ERR_IO = 4,
	LIBPTOUCH_ERR_UNSUPPORTED = 5,
	LIBPTOUCH_ERR_NOT_FOUND = 6,
	LIBPTOUCH_ERR_IMAGE = 7,
} libptouch_err_t;

/** lsusb 例: PT-P900W — Brother Industries, Ltd (04f9:2085) */
#define LIBPTOUCH_USB_VID_BROTHER 0x04f9u
#define LIBPTOUCH_USB_PID_PTP900W 0x2085u
/** PT-P750W / PT-P710BT（cv_ptp750w_710bt_jpn_raster_102.pdf Appendix A） */
#define LIBPTOUCH_USB_PID_PTP750W 0x2062u
#define LIBPTOUCH_USB_PID_PTP710BT 0x20afu

libptouch_ctx *libptouch_create(void);
void libptouch_destroy(libptouch_ctx *ctx);

/** 人が読める英語メッセージ（スレッド非安全: ctx ごと） */
const char *libptouch_strerror(const libptouch_ctx *ctx);
libptouch_err_t libptouch_last_error(const libptouch_ctx *ctx);

/**
 * USB でプリンタを開く（VID/PID で先頭の一致デバイスを開く。libusb のみ）。
 */
libptouch_err_t libptouch_open_usb_vid_pid(libptouch_ctx *ctx, uint16_t vid,
					   uint16_t pid);

/**
 * 既定機種（@ref LIBPTOUCH_USB_VID_BROTHER / @ref LIBPTOUCH_USB_PID_PTP900W）を開く。
 * 別機種は @ref libptouch_open_usb_vid_pid に機種ごとの VID/PID を渡す。
 */
libptouch_err_t libptouch_open_usb(libptouch_ctx *ctx);

void libptouch_close(libptouch_ctx *ctx);

typedef struct {
	uint32_t width_dots;  /**< ラスター幅（ドット） */
	uint32_t height_dots; /**< ラスター高さ（ドット・走査方向は実装と機種に依存） */
	uint8_t margin_mm;    /**< 余白など（機種・仕様に合わせて使用） */
} libptouch_raster_params_t;

typedef struct {
	uint8_t media_width_code;   /**< status[10] */
	uint8_t media_kind_code;    /**< status[11] */
	double print_dpi;           /**< 印字幅方向 DPI（現状 180 or 360） */
	double feed_dpi;            /**< 送り方向 DPI（ESC i d の基準） */
	double tape_width_mm;       /**< 装着テープ幅（mm）。例: 3.5, 6, 9, 12, 18, 24, 36 */
	uint16_t printable_dots;    /**< 現在テープで印字可能な幅（ドット） */
	uint16_t left_margin_dots;  /**< 左余白（ドット） */
	uint16_t right_margin_dots; /**< 右余白（ドット） */
	uint16_t min_feed_dots;     /**< 仕様上の最小送り量（ドット）。現在は 14 */
	double min_feed_mm;         /**< 最小送り量（mm） */
} libptouch_media_info_t;

/**
 * バッファサイズとパラメータの整合性のみ検査（USB 不要）。--dry-run 用。
 */
libptouch_err_t libptouch_check_raster(libptouch_ctx *ctx,
				     const uint8_t *data, size_t data_len,
				     const libptouch_raster_params_t *params);

/**
 * 現在装着テープの情報を取得する（USB 接続済み必須）。
 * ステータスと機種プロファイルからテープ幅・印字可能幅・最小余白量を返す。
 */
libptouch_err_t libptouch_get_current_media_info(libptouch_ctx *ctx,
						 libptouch_media_info_t *out_info);

/**
 * 1 ビット packed ラスターを USB で印刷（各機種のラスター PDF 準拠）。
 * 印字前にステータスでテープ幅を読み、印刷可能ドット内に画像を中央配置する。
 * width_dots は装着テープの印刷可能幅以下であること。PT-P900 系は幅 360dpi、
 * PT-P750W / PT-P710BT は幅 180dpi（cv_ptp750w_710bt_jpn_raster_102.pdf）のドット列を想定。
 * @param margin_mm 余白（フィード）量。0 のとき PDF の最小 1mm（14 ドット）相当を送る。
 * 印刷時は内部でドット列を転置する（テープ幅方向とバッファの縦横の対応）。
 * @param data 1 行あたり width_dots ビットを ceil(width_dots/8) バイトで並べた連続領域
 * @param data_len 期待値: height * row_bytes, row_bytes = (width_dots + 7) / 8
 */
libptouch_err_t libptouch_print_raster(libptouch_ctx *ctx,
				       const uint8_t *data, size_t data_len,
				       const libptouch_raster_params_t *params);

/** 二値化の既定しきい値（輝度 0–255、これ未満を黒ドット） */
#define LIBPTOUCH_PNG_DEFAULT_THRESHOLD 128u

typedef struct {
	uint8_t threshold; /**< 輝度がこれ未満なら黒（1）、以上なら白（0） */
} libptouch_png_options_t;

typedef struct {
	uint8_t threshold; /**< 輝度がこれ未満なら黒（1）、以上なら白（0） */
} libptouch_svg_options_t;

/**
 * PNG ファイルを読み、1bit packed ラスターに変換する（libpng）。
 * @param out_raster malloc 済みバッファのポインタを返す。不要時は @ref libptouch_free_raster で解放。
 */
libptouch_err_t libptouch_png_file_to_raster(libptouch_ctx *ctx, const char *path,
					     const libptouch_png_options_t *options,
					     uint8_t **out_raster, size_t *out_raster_bytes,
					     libptouch_raster_params_t *out_params);

/**
 * SVG ファイルを現在装着中テープの印字可能幅に合わせて 1bit packed ラスターへ変換する
 * （librsvg + cairo）。
 * @note 現在テープ幅を取得するため、事前に @ref libptouch_open_usb などで USB 接続が必要。
 * @param out_raster malloc 済みバッファのポインタを返す。不要時は @ref libptouch_free_raster で解放。
 */
libptouch_err_t libptouch_svg_file_to_raster_fit_current_tape(
	libptouch_ctx *ctx, const char *path,
	const libptouch_svg_options_t *options, uint8_t **out_raster,
	size_t *out_raster_bytes, libptouch_raster_params_t *out_params);

void libptouch_free_raster(uint8_t *raster);

/** ステータス情報リクエスト（ESC i S）の応答バイト数（cv_ptp900_jpn_raster_102.pdf） */
#define LIBPTOUCH_STATUS_LENGTH 32u

/**
 * プリンタからステータスを読む（USB オープン済みであること）。
 * 送信: 初期化 ESC @ のあと ESC i S。応答は @ref LIBPTOUCH_STATUS_LENGTH バイト固定。
 */
libptouch_err_t libptouch_get_status(libptouch_ctx *ctx,
				     uint8_t *status /* length @ref LIBPTOUCH_STATUS_LENGTH */);

/** ステータス 32 バイトを人が読める形で出力（テープ幅・種類・色など） */
void libptouch_status_fprint(FILE *fp,
			     const uint8_t *status /* length @ref LIBPTOUCH_STATUS_LENGTH */);

#ifdef __cplusplus
}
#endif

#endif /* LIBPTOUCH_H */