mirror of
https://github.com/EsotericSoftware/spine-runtimes.git
synced 2026-03-26 22:49:01 +08:00
7b0bf128ff
- Replace MixBlend/MixDirection with bool fromSetup/add/out in all timeline apply() signatures - Remove MixBlend.h and MixDirection.h (no longer used) - Add Timeline::_additive and _instant fields - Replace TrackEntry holdPrevious/interruptAlpha/mixBlend with additive/keepHold - Rewrite AnimationState hold system with bitmask (Subsequent/First/Hold/HoldFirst) - Rewrite applyMixingFrom alpha computation - Rename Skin::AttachmentMap::Entry::_name to _placeholderName - Fix SkeletonBinary::readLong() sign extension bug truncating 64-bit hashes - Fix SkeletonSerializer sequence and bones null/empty parity with Java - Add transition frame testing to HeadlessTest - Port all doc updates from spine-libgdx
127 lines
4.4 KiB
C++
127 lines
4.4 KiB
C++
/******************************************************************************
|
|
* Spine Runtimes License Agreement
|
|
* Last updated April 5, 2025. Replaces all prior versions.
|
|
*
|
|
* Copyright (c) 2013-2025, Esoteric Software LLC
|
|
*
|
|
* Integration of the Spine Runtimes into software or otherwise creating
|
|
* derivative works of the Spine Runtimes is permitted under the terms and
|
|
* conditions of Section 2 of the Spine Editor License Agreement:
|
|
* http://esotericsoftware.com/spine-editor-license
|
|
*
|
|
* Otherwise, it is permitted to integrate the Spine Runtimes into software
|
|
* or otherwise create derivative works of the Spine Runtimes (collectively,
|
|
* "Products"), provided that each user of the Products must obtain their own
|
|
* Spine Editor license and redistribution of the Products in any form must
|
|
* include this license and copyright notice.
|
|
*
|
|
* THE SPINE RUNTIMES ARE PROVIDED BY ESOTERIC SOFTWARE LLC "AS IS" AND ANY
|
|
* EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
|
|
* WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
|
* DISCLAIMED. IN NO EVENT SHALL ESOTERIC SOFTWARE LLC BE LIABLE FOR ANY
|
|
* DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
|
|
* (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES,
|
|
* BUSINESS INTERRUPTION, OR LOSS OF USE, DATA, OR PROFITS) HOWEVER CAUSED AND
|
|
* ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
|
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
|
|
* THE SPINE RUNTIMES, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
*****************************************************************************/
|
|
|
|
#ifndef Spine_RegionAttachment_h
|
|
#define Spine_RegionAttachment_h
|
|
|
|
#include <spine/Attachment.h>
|
|
#include <spine/Array.h>
|
|
#include <spine/Color.h>
|
|
#include <spine/HasRendererObject.h>
|
|
#include <spine/Sequence.h>
|
|
#include <spine/TextureRegion.h>
|
|
|
|
namespace spine {
|
|
class Slot;
|
|
class SlotPose;
|
|
|
|
/// Attachment that displays a texture region.
|
|
class SP_API RegionAttachment : public Attachment {
|
|
friend class SkeletonBinary;
|
|
friend class SkeletonJson;
|
|
friend class AtlasAttachmentLoader;
|
|
|
|
RTTI_DECL
|
|
|
|
public:
|
|
explicit RegionAttachment(const String &name, Sequence *sequence);
|
|
|
|
virtual ~RegionAttachment();
|
|
|
|
/// Transforms the attachment's four vertices to world coordinates.
|
|
/// @param slot The parent slot.
|
|
/// @param vertexOffsets The vertex offsets.
|
|
/// @param worldVertices The output world vertices. Must have a length greater than or equal to offset + 8.
|
|
/// @param offset The worldVertices index to begin writing values.
|
|
/// @param stride The number of worldVertices entries between the value pairs written.
|
|
void computeWorldVertices(Slot &slot, float *vertexOffsets, float *worldVertices, size_t offset, size_t stride = 2);
|
|
|
|
void computeWorldVertices(Slot &slot, Array<float> &vertexOffsets, Array<float> &worldVertices, size_t offset, size_t stride = 2);
|
|
|
|
/// Returns the vertex offsets for the specified slot pose.
|
|
Array<float> &getOffsets(SlotPose &pose);
|
|
|
|
float getX();
|
|
void setX(float inValue);
|
|
|
|
float getY();
|
|
void setY(float inValue);
|
|
|
|
float getScaleX();
|
|
void setScaleX(float inValue);
|
|
|
|
float getScaleY();
|
|
void setScaleY(float inValue);
|
|
|
|
/// The local rotation in degrees, counter clockwise.
|
|
float getRotation();
|
|
void setRotation(float inValue);
|
|
|
|
float getWidth();
|
|
void setWidth(float inValue);
|
|
|
|
float getHeight();
|
|
void setHeight(float inValue);
|
|
|
|
Sequence &getSequence();
|
|
|
|
void updateSequence();
|
|
|
|
const String &getPath();
|
|
void setPath(const String &inValue);
|
|
|
|
Color &getColor();
|
|
|
|
virtual Attachment ©() override;
|
|
|
|
/// Computes UVs and offsets for a region attachment.
|
|
/// @param uvs Output array for the computed UVs, length of 8.
|
|
/// @param offset Output array for the computed vertex offsets, length of 8.
|
|
static void computeUVs(TextureRegion *region, float x, float y, float scaleX, float scaleY, float rotation, float width, float height,
|
|
Array<float> &offset, Array<float> &uvs);
|
|
|
|
private:
|
|
static const int BLX;
|
|
static const int BLY;
|
|
static const int ULX;
|
|
static const int ULY;
|
|
static const int URX;
|
|
static const int URY;
|
|
static const int BRX;
|
|
static const int BRY;
|
|
|
|
Sequence *_sequence;
|
|
float _x, _y, _scaleX, _scaleY, _rotation, _width, _height;
|
|
String _path;
|
|
Color _color;
|
|
};
|
|
}
|
|
|
|
#endif /* Spine_RegionAttachment_h */
|