John McCardle
1dec6fa00f
Replace placeholder docstrings ("SFML Vector Object", "SFML Font Object",
etc.) with comprehensive constructor signatures, argument descriptions,
and property listings matching the documentation standard used by other
types like Color and Frame.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
89 lines
3.8 KiB
C++
89 lines
3.8 KiB
C++
#pragma once
|
|
#include "Common.h"
|
|
#include "Python.h"
|
|
|
|
class PyTexture;
|
|
|
|
typedef struct {
|
|
PyObject_HEAD
|
|
std::shared_ptr<PyTexture> data;
|
|
} PyTextureObject;
|
|
|
|
class PyTexture : public std::enable_shared_from_this<PyTexture>
|
|
{
|
|
private:
|
|
sf::Texture texture;
|
|
std::string source;
|
|
int sheet_width, sheet_height;
|
|
|
|
// Private default constructor for factory methods
|
|
PyTexture() : source("<uninitialized>"), sprite_width(0), sprite_height(0), sheet_width(0), sheet_height(0) {}
|
|
|
|
public:
|
|
int sprite_width, sprite_height; // just use them read only, OK?
|
|
PyTexture(std::string filename, int sprite_w, int sprite_h);
|
|
|
|
// #144: Factory method to create texture from rendered content (snapshot)
|
|
static std::shared_ptr<PyTexture> from_rendered(sf::RenderTexture& render_tex);
|
|
|
|
// Factory method to create texture from an sf::Image (for LDtk flip-baked atlases)
|
|
static std::shared_ptr<PyTexture> from_image(
|
|
const sf::Image& img, int sprite_w, int sprite_h,
|
|
const std::string& name = "<generated>");
|
|
sf::Sprite sprite(int index, sf::Vector2f pos = sf::Vector2f(0, 0), sf::Vector2f s = sf::Vector2f(1.0, 1.0));
|
|
int getSpriteCount() const { return sheet_width * sheet_height; }
|
|
|
|
// Get the underlying sf::Texture for 3D rendering
|
|
const sf::Texture* getSFMLTexture() const { return &texture; }
|
|
|
|
PyObject* pyObject();
|
|
static PyObject* repr(PyObject*);
|
|
static Py_hash_t hash(PyObject*);
|
|
static int init(PyTextureObject*, PyObject*, PyObject*);
|
|
static PyObject* pynew(PyTypeObject* type, PyObject* args=NULL, PyObject* kwds=NULL);
|
|
|
|
// Getters for properties
|
|
static PyObject* get_sprite_width(PyTextureObject* self, void* closure);
|
|
static PyObject* get_sprite_height(PyTextureObject* self, void* closure);
|
|
static PyObject* get_sheet_width(PyTextureObject* self, void* closure);
|
|
static PyObject* get_sheet_height(PyTextureObject* self, void* closure);
|
|
static PyObject* get_sprite_count(PyTextureObject* self, void* closure);
|
|
static PyObject* get_source(PyTextureObject* self, void* closure);
|
|
|
|
static PyGetSetDef getsetters[];
|
|
|
|
// Methods (classmethods and instance methods)
|
|
static PyObject* from_bytes(PyObject* cls, PyObject* args, PyObject* kwds);
|
|
static PyObject* composite(PyObject* cls, PyObject* args, PyObject* kwds);
|
|
static PyObject* hsl_shift(PyTextureObject* self, PyObject* args, PyObject* kwds);
|
|
static PyMethodDef methods[];
|
|
};
|
|
|
|
namespace mcrfpydef {
|
|
inline PyTypeObject PyTextureType = {
|
|
.ob_base = {.ob_base = {.ob_refcnt = 1, .ob_type = NULL}, .ob_size = 0},
|
|
.tp_name = "mcrfpy.Texture",
|
|
.tp_basicsize = sizeof(PyTextureObject),
|
|
.tp_itemsize = 0,
|
|
.tp_repr = PyTexture::repr,
|
|
.tp_hash = PyTexture::hash,
|
|
.tp_flags = Py_TPFLAGS_DEFAULT,
|
|
.tp_doc = PyDoc_STR(
|
|
"Texture(filename: str, sprite_width: int = 0, sprite_height: int = 0)\n\n"
|
|
"A texture atlas for sprites and tiles.\n\n"
|
|
"Args:\n"
|
|
" filename: Path to an image file (PNG, BMP, etc.).\n"
|
|
" sprite_width: Width of each sprite cell in pixels (0 = full image).\n"
|
|
" sprite_height: Height of each sprite cell in pixels (0 = full image).\n\n"
|
|
"Properties:\n"
|
|
" sprite_width, sprite_height (int, read-only): Cell dimensions.\n"
|
|
" sheet_width, sheet_height (int, read-only): Grid dimensions in cells.\n"
|
|
" sprite_count (int, read-only): Total number of sprite cells.\n"
|
|
" source (str, read-only): File path used to load this texture.\n"
|
|
),
|
|
.tp_getset = PyTexture::getsetters,
|
|
//.tp_base = &PyBaseObject_Type,
|
|
.tp_init = (initproc)PyTexture::init,
|
|
.tp_new = PyType_GenericNew, //PyTexture::pynew,
|
|
};
|
|
}
|