mirror of
https://github.com/EsotericSoftware/spine-runtimes.git
synced 2026-03-26 06:29:02 +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
114 lines
4.4 KiB
C++
114 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_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
|
|
/// 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 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();
|
|
|
|
/// The bones that affect the vertices. The entries are, for each vertex, the number of bones affecting the
|
|
/// vertex followed by that many bone indices, which is the Skeleton::getBones() index. Empty if this attachment
|
|
/// has no weights.
|
|
Array<int> &getBones();
|
|
|
|
void setBones(Array<int> &bones);
|
|
|
|
/// The vertex positions in the bone's coordinate system. For a non-weighted attachment, the values are x,y pairs
|
|
/// for each vertex. For a weighted attachment, the values are x,y,weight triplets for each bone affecting each
|
|
/// vertex.
|
|
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;
|
|
|
|
private:
|
|
const int _id;
|
|
|
|
static int getNextID();
|
|
};
|
|
}
|
|
|
|
#endif /* Spine_VertexAttachment_h */
|