summaryrefslogtreecommitdiff
path: root/indra/llprimitive/llmaterialid.h
blob: 41dd5a87109ea035dcf0be188733230dcef8c2f0 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
/**
* @file   llmaterialid.h
* @brief  Header file for llmaterialid
* @author Stinson@lindenlab.com
*
* $LicenseInfo:firstyear=2012&license=viewerlgpl$
* Second Life Viewer Source Code
* Copyright (C) 2012, Linden Research, Inc.
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation;
* version 2.1 of the License only.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the Free Software
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
*
* Linden Research, Inc., 945 Battery Street, San Francisco, CA  94111  USA
* $/LicenseInfo$
*/
#ifndef LL_LLMATERIALID_H
#define LL_LLMATERIALID_H

#define MATERIAL_ID_SIZE 16

#include <string>
#include "llsd.h"

class LLMaterialID
{
public:
    LLMaterialID();
    LLMaterialID(const LLSD& pMaterialID);
    LLMaterialID(const LLSD::Binary& pMaterialID);
    LLMaterialID(const void* pMemory);
    LLMaterialID(const LLMaterialID& pOtherMaterialID);
    LLMaterialID(const LLUUID& lluid);
    ~LLMaterialID();

    bool          operator == (const LLMaterialID& pOtherMaterialID) const;
    bool          operator != (const LLMaterialID& pOtherMaterialID) const;

    bool          operator < (const LLMaterialID& pOtherMaterialID) const;
    bool          operator <= (const LLMaterialID& pOtherMaterialID) const;
    bool          operator > (const LLMaterialID& pOtherMaterialID) const;
    bool          operator >= (const LLMaterialID& pOtherMaterialID) const;

    LLMaterialID& operator = (const LLMaterialID& pOtherMaterialID);

    bool          isNull() const;

    const U8*     get() const;
    void          set(const void* pMemory);
    void          clear();

    LLSD          asLLSD() const;
    std::string   asString() const;
    LLUUID        asUUID() const;

    friend std::ostream& operator<<(std::ostream& s, const LLMaterialID &material_id);

    static const LLMaterialID null;

private:
    // definitions follow class
    friend std::hash<LLMaterialID>;
    friend size_t hash_value(const LLMaterialID&) noexcept;

    void parseFromBinary(const LLSD::Binary& pMaterialID);
    void copyFromOtherMaterialID(const LLMaterialID& pOtherMaterialID);
    int  compareToOtherMaterialID(const LLMaterialID& pOtherMaterialID) const;

    U8 mID[MATERIAL_ID_SIZE];
} ;

// std::hash implementation for LLMaterialID
namespace std
{
    template<> struct hash<LLMaterialID>
    {
        inline size_t operator()(const LLMaterialID& id) const noexcept
        {
            size_t h = 0;
            // Golden ratio hash with avalanche mixing
            // Process 8 bytes at a time by manually constructing 64-bit values
            // Shift by 31: mixes upper half into lower half for better bit distribution
            // Shift by 47: ensures highest bits influence final hash output
            for (int i = 0; i < MATERIAL_ID_SIZE; i += 8) {
                size_t chunk = (size_t)id.mID[i] | ((size_t)id.mID[i + 1] << 8) |
                               ((size_t)id.mID[i+2] << 16) | ((size_t)id.mID[i+3] << 24) |
                               ((size_t)id.mID[i+4] << 32) | ((size_t)id.mID[i+5] << 40) |
                               ((size_t)id.mID[i + 6] << 48) | ((size_t)id.mID[i + 7] << 56);
                h ^= (chunk * 0x9e3779b97f4a7c15ULL) ^ (h >> 31) ^ (h >> 47);
            }
            return h;
        }
    };
}

// For use with boost::container_hash
inline size_t hash_value(const LLMaterialID& id) noexcept
{
    return std::hash<LLMaterialID>{}(id);
}

#endif // LL_LLMATERIALID_H