mirror of
https://github.com/EsotericSoftware/spine-runtimes.git
synced 2025-12-21 01:36:02 +08:00
109 lines
3.9 KiB
C++
109 lines
3.9 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_VertexAttachment_h
|
|
#define Spine_VertexAttachment_h
|
|
|
|
#include <spine/Attachment.h>
|
|
|
|
#include <spine/Array.h>
|
|
|
|
namespace spine {
|
|
class Slot;
|
|
class Skeleton;
|
|
|
|
/// An attachment with vertices that are transformed by one or more bones and can be deformed by a slot's
|
|
/// SlotPose::getDeform().
|
|
class SP_API VertexAttachment : public Attachment {
|
|
friend class SkeletonBinary;
|
|
|
|
friend class SkeletonJson;
|
|
|
|
friend class DeformTimeline;
|
|
|
|
RTTI_DECL
|
|
|
|
public:
|
|
explicit VertexAttachment(const String &name);
|
|
|
|
virtual ~VertexAttachment();
|
|
|
|
|
|
/// Transforms the attachment's local vertices to world coordinates. If the slot's SlotPose::getDeform()
|
|
/// is not empty, it is used to deform the vertices.
|
|
///
|
|
/// See https://esotericsoftware.com/spine-runtime-skeletons#World-transforms World transforms in the Spine
|
|
/// Runtimes Guide.
|
|
/// @param start The index of the first vertices value to transform. Each vertex has 2 values, x and y.
|
|
/// @param count The number of world vertex values to output. Must be <= WorldVerticesLength - start.
|
|
/// @param worldVertices The output world vertices. Must have a length >= offset + count * stride / 2.
|
|
/// @param offset The worldVertices index to begin writing values.
|
|
/// @param stride The number of worldVertices entries between the value pairs written.
|
|
virtual void computeWorldVertices(Skeleton &skeleton, Slot &slot, size_t start, size_t count, float *worldVertices, size_t offset,
|
|
size_t stride = 2);
|
|
|
|
virtual void computeWorldVertices(Skeleton &skeleton, Slot &slot, size_t start, size_t count, Array<float> &worldVertices, size_t offset,
|
|
size_t stride = 2);
|
|
|
|
/// Gets a unique ID for this attachment.
|
|
int getId();
|
|
|
|
Array<int> &getBones();
|
|
|
|
void setBones(Array<int> &bones);
|
|
|
|
Array<float> &getVertices();
|
|
|
|
void setVertices(Array<float> &vertices);
|
|
|
|
size_t getWorldVerticesLength();
|
|
|
|
void setWorldVerticesLength(size_t inValue);
|
|
|
|
Attachment *getTimelineAttachment();
|
|
|
|
void setTimelineAttachment(Attachment *attachment);
|
|
|
|
void copyTo(VertexAttachment &other);
|
|
|
|
protected:
|
|
Array<int> _bones;
|
|
Array<float> _vertices;
|
|
size_t _worldVerticesLength;
|
|
Attachment *_timelineAttachment;
|
|
|
|
private:
|
|
const int _id;
|
|
|
|
static int getNextID();
|
|
};
|
|
}
|
|
|
|
#endif /* Spine_VertexAttachment_h */
|