LlSameGroup - Revision history

Gwyneth Llewelyn: Replaced with ; added a LOT of links. modified things here and there to improve running time

2023-02-04T04:52:33Z

Replaced <source> with <syntaxhighlight>; added a LOT of links. modified things here and there to improve running time

← Older revision		Revision as of 21:52, 3 February 2023
Line 8:		Line 8:
	\|p1_type=key\|p1_name=uuid		\|p1_type=key\|p1_name=uuid
	\|func_desc		\|func_desc
	\|return_text=that is [[TRUE]] if {{LSLP\|uuid}} and the prim the script is in are of the same group, otherwise [[FALSE]].		\|return_text=that is [[TRUE]] if {{LSLP\|uuid}} and the [[prim]] the [[script]] is in are of the same [[group]], otherwise [[FALSE]].
	\|func_footnote=This function compares the group-uuid of the prim containing the script to that of the group-uuid of what {{LSLP\|uuid}} describes.		\|func_footnote=This function compares the {{mono\|group-uuid}} of the [[prim]] containing the script to that of the {{mono\|group-uuid}} of what {{LSLP\|uuid}} describes.
	It answers these two questions:		It answers these two questions:
	*"Is the script's prim in the same group as {{LSLP\|uuid}}?"		*"Is the script's prim in the same [[group]] as {{LSLP\|uuid}}?"
	*"Is the group-uuid of the script's prim equal to {{LSLP\|uuid}}?"		*"Is the {{mono\|group-uuid}} of the script's prim equal to {{LSLP\|uuid}}?"
	\|spec=		\|spec=
	The group of the prim the script is in is...		The group of the prim the script is in is...
	* The group the prim is set-to		* The group the prim is set-to
	* The group the prim is deeded-to		* The group the prim is deeded-to
	* The group the prim is otherwise owned by		* The group the prim is otherwise [[Owner\|owned by]]
	* If no group information is set, the group-uuid used for this is [[NULL_KEY]].		* If no group information is set, the {{mono\|group-uuid}} used for this is [[NULL_KEY]].

	The group of the {{LSLP\|uuid}} is...		The group of the {{LSLP\|uuid}} is...
	* If {{LSLP\|uuid}} is a prim (known to the region)...		* If {{LSLP\|uuid}} is a prim (known to the [[region]])...
	** and it is an attachment, the active group of the owner*		** and it is an [[attachment]], the active group of the owner*
	** The group the prim is set-to		** The group the prim is set-to
	** The group the prim is deeded-to		** The group the prim is deeded-to
	** The group the prim is otherwise owned by		** The group the prim is otherwise owned by
	** If no group information is set, the group-uuid used for this is [[NULL_KEY]].		** If no group information is set, the {{mono\|group-uuid}} used for this is [[NULL_KEY]].
	* If {{LSLP\|uuid}} is an avatar (known to the region)...		* If {{LSLP\|uuid}} is an [[avatar]] (known to the [[region]])...
	** The active group of the avatar.		** The active group of the avatar.
	** If no group information is set, the group-uuid used for this is [[NULL_KEY]].		** If no group information is set, the {{mono\|group-uuid}} used for this is [[NULL_KEY]].
	* Otherwise, treat {{LSLP\|uuid}} AS the group-uuid.		* Otherwise, treat {{LSLP\|uuid}} AS the {{mono\|group-uuid}}.
	** This means that instead of doing "Is the script's prim in the same group as {{LSLP\|uuid}}?", it becomes "Is the group-uuid of the script's prim equal to {{LSLP\|uuid}}?"		** This means that instead of doing "Is the script's prim in the same group as {{LSLP\|uuid}}?", it becomes "Is the {{mono\|group-uuid}} of the script's prim equal to {{LSLP\|uuid}}?"
	Note: No group, prim, or avatar share the same uuid.		'''Note:''' No group, prim, or avatar share the same {{LSLP\|uuid}}.

	In pseudocode:		In pseudocode:
	<~~source~~ lang="lsl2">integer llSameGroup(key uuid){		<syntaxhighlight lang="lsl2">integer llSameGroup(key uuid){
	key group = getGroupKey(llGetKey());		key group = getGroupKey(llGetKey());
	if(uuid == group)		if(uuid == group)
Line 42:		Line 42:
	return TRUE;		return TRUE;
	return FALSE;		return FALSE;
	}</~~source~~>		}</syntaxhighlight>
	\|caveats=		\|caveats=
	*Not so obvious is that it returns [[TRUE]] if the object is not set to a group (i.e. "(none)") and either the AV with the given key has no group active or the function is called with a [[NULL_KEY]].		*Not so obvious is that it returns [[TRUE]] if the [[object]] is not set to a group (i.e. "(none)") and either the [[avatar\|AV]] with the given [[key]] has no group active or the function is called with a [[NULL_KEY]].
	\|constants		\|constants
	\|examples=		\|examples=
	<~~source~~ lang="lsl2">		<syntaxhighlight lang="lsl2">
	// Gives inventory object only to agents with the same active group		// Gives inventory object only to agents with the same active group

Line 72:		Line 72:
	}		}
	}		}
	</~~source~~>		</syntaxhighlight>
	\|helpers=		\|helpers=
	To determine if an avatar is an object's owner when deeded to group, you should use a function similar to that provided for [[LlGetOwner#Useful_Snippets\|llGetOwner]]().		To determine if an avatar is an object's owner when deeded to group, you should use a function similar to that provided for [[LlGetOwner#Useful_Snippets\|llGetOwner]]().

	The following uses llSameGroup() to determine if a parcel is rezzable based on the object's active group and parcel details. Useful for preventing unnecessary rez failure notices from various types of attached objects (e.g. guns, water/skywalk ~~HUDs~~, etc).		The following uses llSameGroup() to determine if a [[parcel]] is [[Rez\|rezzable]] based on the object's active group and parcel details. Useful for preventing unnecessary rez failure notices from various types of attached objects (e.g. guns, water/skywalk [[HUD]]s, etc).
	<~~source~~ lang="lsl2">		<syntaxhighlight lang="lsl2">
	/*		/*
	By Aryn Gellner		By Aryn Gellner
Line 87:		Line 87:
	{		{
	integer parcel_flags = llGetParcelFlags(pos);		integer parcel_flags = llGetParcelFlags(pos);
	if(parcel_flags & PARCEL_FLAG_ALLOW_CREATE_OBJECTS)		if (parcel_flags & PARCEL_FLAG_ALLOW_CREATE_OBJECTS)
	{		{
	return true;//Anyone can rez. No further checks are needed.		return true; //Anyone can rez. No further checks are needed.
	}		}

	//Ok, not just anyone can rez. Maybe they share an owner or the land allows for group rezzing.		//Ok, not just anyone can rez. Maybe they share an owner or the land allows for group rezzing.
	//So ~~lets~~ get the parcel owner_id and group_id		//So let's get the parcel owner_id and group_id

	list details = llGetParcelDetails(pos, [PARCEL_DETAILS_OWNER, PARCEL_DETAILS_GROUP]);		list details = llGetParcelDetails(pos, [PARCEL_DETAILS_OWNER, PARCEL_DETAILS_GROUP]);

	if(llList2Key(details, 0) == llGetOwner())		if (llList2Key(details, 0) == llGetOwner())
	{		{
	return TRUE;//Owner can always rez.		return TRUE; //Owner can always rez.
	}		}

Line 105:		Line 105:
	return (parcel_flags & PARCEL_FLAG_ALLOW_CREATE_GROUP_OBJECTS) && llSameGroup(llList2Key(details, 1));		return (parcel_flags & PARCEL_FLAG_ALLOW_CREATE_GROUP_OBJECTS) && llSameGroup(llList2Key(details, 1));
	}		}
	</~~source~~>		</syntaxhighlight>
	\|also_functions={{LSL DefineRow\|\|[[llDetectedGroup]]\|Used in conjunction with {{LSLGC\|Detected\|detection}} events}}		\|also_functions={{LSL DefineRow\|\|[[llDetectedGroup]]\|Used in conjunction with {{LSLGC\|Detected\|detection}} events}}
	{{LSL DefineRow\|\|[[llGetAttachedList]]\|Together with [[llGetObjectDetails]] and [[OBJECT_GROUP]], it can be used to determine the active group of an avatar that is wearing at least one non-HUD attachment.}}		{{LSL DefineRow\|\|[[llGetAttachedList]]\|Together with [[llGetObjectDetails]] and [[OBJECT_GROUP]], it can be used to determine the active group of an avatar that is wearing at least one non-HUD attachment.}}

Strife Onizuka: If you revert an edit without comment, that reverted edit needs to be obviously wrong. If you disagree with an edit, produce a superior edit and leave a comment; do not just revert it.

2016-04-28T00:31:58Z

If you revert an edit without comment, that reverted edit needs to be obviously wrong. If you disagree with an edit, produce a superior edit and leave a comment; do not just revert it.

← Older revision		Revision as of 17:31, 27 April 2016
Line 81:		Line 81:
	By Aryn Gellner		By Aryn Gellner
	pos - position (in region coordinates) to check against.		pos - position (in region coordinates) to check against.
	*/		* Additional Land Owner Test added by Ruthven Willenov, simplified by Strife
	/*
	Additional Land Owner Test added by Ruthven Willenov
	*/		*/

	integer is_rezzable(vector pos)		integer is_rezzable(vector pos)
	{		{
	~~list details = llGetParcelDetails(pos, [PARCEL_DETAILS_GROUP, PARCEL_DETAILS_OWNER]);~~
	~~key group_id = llList2Key(details, 0);~~
	~~key owner_id = llList2Key(details, 1);~~

	integer parcel_flags = llGetParcelFlags(pos);		integer parcel_flags = llGetParcelFlags(pos);
	~~if(owner_id != llGetOwner())~~
	{
	if(parcel_flags & PARCEL_FLAG_ALLOW_CREATE_OBJECTS)		if(parcel_flags & PARCEL_FLAG_ALLOW_CREATE_OBJECTS)
	{		{
	return ~~TRUE;~~		return true;//Anyone can rez. No further checks are needed.
	}
	~~else if((parcel_flags & PARCEL_FLAG_ALLOW_CREATE_GROUP_OBJECTS) && llSameGroup(group_id))~~
	{
	~~return TRUE~~;
	}		}
	~~else~~
			//Ok, not just anyone can rez. Maybe they share an owner or the land allows for group rezzing.
			//So lets get the parcel owner_id and group_id

			list details = llGetParcelDetails(pos, [PARCEL_DETAILS_OWNER, PARCEL_DETAILS_GROUP]);

			if(llList2Key(details, 0) == llGetOwner())
	{		{
	return ~~FALSE~~;		return TRUE;//Owner can always rez.
	}		}
	}
	~~else{~~return ~~TRUE~~;}		//Since what we are going to return is a boolean just return the result of the boolean expression.
			return (parcel_flags & PARCEL_FLAG_ALLOW_CREATE_GROUP_OBJECTS) && llSameGroup(llList2Key(details, 1));
	}		}
	</source>		</source>

Ruthven Willenov at 03:24, 25 April 2016

2016-04-25T03:24:07Z

← Older revision		Revision as of 20:24, 24 April 2016
Line 81:		Line 81:
	By Aryn Gellner		By Aryn Gellner
	pos - position (in region coordinates) to check against.		pos - position (in region coordinates) to check against.
	* Additional Land Owner Test added by Ruthven Willenov		*/
			/*
			Additional Land Owner Test added by Ruthven Willenov
	*/		*/

Line 91:		Line 93:

	integer parcel_flags = llGetParcelFlags(pos);		integer parcel_flags = llGetParcelFlags(pos);
	if(owner_id == llGetOwner() \|\| (parcel_flags & PARCEL_FLAG_ALLOW_CREATE_OBJECTS))		if(owner_id != llGetOwner())
			{
			if(parcel_flags & PARCEL_FLAG_ALLOW_CREATE_OBJECTS)
	{		{
	return TRUE;		return TRUE;
	}		}
	~~return~~ (parcel_flags & PARCEL_FLAG_ALLOW_CREATE_GROUP_OBJECTS) && llSameGroup(group_id);		else if((parcel_flags & PARCEL_FLAG_ALLOW_CREATE_GROUP_OBJECTS) && llSameGroup(group_id))
			{
			return TRUE;
			}
			else
			{
			return FALSE;
			}
			}
			else{return TRUE;}
	}		}
	</source>		</source>

Strife Onizuka at 19:56, 24 April 2016

2016-04-24T19:56:11Z

← Older revision		Revision as of 12:56, 24 April 2016
Line 81:		Line 81:
	By Aryn Gellner		By Aryn Gellner
	pos - position (in region coordinates) to check against.		pos - position (in region coordinates) to check against.
	*/		* Additional Land Owner Test added by Ruthven Willenov
	/*
	Additional Land Owner Test added by Ruthven Willenov
	*/		*/

Strife Onizuka: Whitespace consistency and simplification.

2016-04-24T19:52:41Z

Whitespace consistency and simplification.

← Older revision		Revision as of 12:52, 24 April 2016
Line 93:		Line 93:

	integer parcel_flags = llGetParcelFlags(pos);		integer parcel_flags = llGetParcelFlags(pos);
	if(owner_id != llGetOwner())		if(owner_id == llGetOwner() \|\| (parcel_flags & PARCEL_FLAG_ALLOW_CREATE_OBJECTS))
	{
	if(parcel_flags & PARCEL_FLAG_ALLOW_CREATE_OBJECTS)
	{
	~~return TRUE;~~
	}
	~~else if((parcel_flags & PARCEL_FLAG_ALLOW_CREATE_GROUP_OBJECTS) && llSameGroup(group_id~~))
	{		{
	return TRUE;		return TRUE;
	}		}
	~~else~~		return (parcel_flags & PARCEL_FLAG_ALLOW_CREATE_GROUP_OBJECTS) && llSameGroup(group_id);
	{
	return ~~FALSE~~;
	}
	}
	~~else{return TRUE;}~~
	}		}
	</source>		</source>

Ruthven Willenov at 05:58, 24 April 2016

2016-04-24T05:58:38Z

← Older revision		Revision as of 22:58, 23 April 2016
Line 82:		Line 82:
	pos - position (in region coordinates) to check against.		pos - position (in region coordinates) to check against.
	*/		*/
			/*
			Additional Land Owner Test added by Ruthven Willenov
			*/

	integer is_rezzable(vector pos)		integer is_rezzable(vector pos)
	{		{
	~~key group_id~~ = ~~llList2Key(~~llGetParcelDetails(pos, [PARCEL_DETAILS_GROUP]), 0);		list details = llGetParcelDetails(pos, [PARCEL_DETAILS_GROUP, PARCEL_DETAILS_OWNER]);
			key group_id = llList2Key(details, 0);
			key owner_id = llList2Key(details, 1);

	integer parcel_flags = llGetParcelFlags(pos);		integer parcel_flags = llGetParcelFlags(pos);
			if(owner_id != llGetOwner())
			{
	if(parcel_flags & PARCEL_FLAG_ALLOW_CREATE_OBJECTS)		if(parcel_flags & PARCEL_FLAG_ALLOW_CREATE_OBJECTS)
	{		{
Line 101:		Line 107:
	return FALSE;		return FALSE;
	}		}
			}
			else{return TRUE;}
	}		}
	</source>		</source>

Sei Lisa at 02:36, 17 December 2015

2015-12-17T02:36:55Z

← Older revision		Revision as of 19:36, 16 December 2015
Line 104:		Line 104:
	</source>		</source>
	\|also_functions={{LSL DefineRow\|\|[[llDetectedGroup]]\|Used in conjunction with {{LSLGC\|Detected\|detection}} events}}		\|also_functions={{LSL DefineRow\|\|[[llDetectedGroup]]\|Used in conjunction with {{LSLGC\|Detected\|detection}} events}}
	{{LSL DefineRow\|\|[[llGetAttachedList]]\|Together with [[llGetObjectDetails]] and [[OBJECT_GROUP]], it can be used to determine the active group of an avatar that is wearing at least one attachment.}}		{{LSL DefineRow\|\|[[llGetAttachedList]]\|Together with [[llGetObjectDetails]] and [[OBJECT_GROUP]], it can be used to determine the active group of an avatar that is wearing at least one non-HUD attachment.}}
	\|also_tests=		\|also_tests=
	{{LSL DefineRow\|\|[[llSameGroup Test]]}}		{{LSL DefineRow\|\|[[llSameGroup Test]]}}

Sei Lisa: add llGetAttachedList to also_functions

2015-12-17T02:29:55Z

add llGetAttachedList to also_functions

← Older revision		Revision as of 19:29, 16 December 2015
Line 104:		Line 104:
	</source>		</source>
	\|also_functions={{LSL DefineRow\|\|[[llDetectedGroup]]\|Used in conjunction with {{LSLGC\|Detected\|detection}} events}}		\|also_functions={{LSL DefineRow\|\|[[llDetectedGroup]]\|Used in conjunction with {{LSLGC\|Detected\|detection}} events}}
			{{LSL DefineRow\|\|[[llGetAttachedList]]\|Together with [[llGetObjectDetails]] and [[OBJECT_GROUP]], it can be used to determine the active group of an avatar that is wearing at least one attachment.}}
	\|also_tests=		\|also_tests=
	{{LSL DefineRow\|\|[[llSameGroup Test]]}}		{{LSL DefineRow\|\|[[llSameGroup Test]]}}

Strife Onizuka at 19:52, 21 March 2015

2015-03-21T19:52:33Z

← Older revision		Revision as of 12:52, 21 March 2015
Line 22:		Line 22:
	The group of the {{LSLP\|uuid}} is...		The group of the {{LSLP\|uuid}} is...
	* If {{LSLP\|uuid}} is a prim (known to the region)...		* If {{LSLP\|uuid}} is a prim (known to the region)...
	** and it is an attachment, the group of the owner*		** and it is an attachment, the active group of the owner*
	** The group the prim is set-to		** The group the prim is set-to
	** The group the prim is deeded-to		** The group the prim is deeded-to
Line 28:		Line 28:
	** If no group information is set, the group-uuid used for this is [[NULL_KEY]].		** If no group information is set, the group-uuid used for this is [[NULL_KEY]].
	* If {{LSLP\|uuid}} is an avatar (known to the region)...		* If {{LSLP\|uuid}} is an avatar (known to the region)...
	** The group of the avatar.		** The active group of the avatar.
	** If no group information is set, the group-uuid used for this is [[NULL_KEY]].		** If no group information is set, the group-uuid used for this is [[NULL_KEY]].
	* Otherwise, treat {{LSLP\|uuid}} AS the group-uuid.		* Otherwise, treat {{LSLP\|uuid}} AS the group-uuid.

Strife Onizuka: I think this pretty much covers all the edge cases.

2015-03-21T19:50:49Z

I think this pretty much covers all the edge cases.

← Older revision		Revision as of 12:50, 21 March 2015
Line 1:		Line 1:
	{{LSL Function		{{LSL Function
	\|inject-2={{LSL Function/uuid\|uuid\|sim=*}}{{LSL Function/group}}		\|inject-2={{LSL Function/uuid\|uuid\|sim=\|group=}}{{LSL Function/group}}
	\|func=llSameGroup		\|func=llSameGroup
	\|sort=SameGroup		\|sort=SameGroup
	\|func_id=219\|func_sleep=0.0\|func_energy=10.0		\|func_id=219\|func_sleep=0.0\|func_energy=10.0
	\|return_type=integer		\|return_type=integer
			\|return_subtype=boolean
	\|p1_type=key\|p1_name=uuid		\|p1_type=key\|p1_name=uuid
	\|func_desc		\|func_desc
	~~Returns "~~TRUE" if ~~the detected object has the same active group as~~ the prim the script is in.		\|return_text=that is [[TRUE]] if {{LSLP\|uuid}} and the prim the script is in are of the same group, otherwise [[FALSE]].
	\|func_footnote=~~Also returns [[TRUE]] if~~ the ~~object is deeded~~ to the same ~~active~~ group as ~~'''~~uuid'''{{~~PBR~~}}		\|func_footnote=This function compares the group-uuid of the prim containing the script to that of the group-uuid of what {{LSLP\|uuid}} describes.
	~~Also returns [[TRUE]] if~~ the ~~object~~ is "set to~~" or~~ deeded to the ~~same~~ group ~~as '''~~group~~'''~~ [[~~UUID~~]] (i.e. ~~key~~ [[~~OBJECT_GROUP~~]])		It answers these two questions:
	~~\|return_text=boolean~~, ~~that~~ is [[~~TRUE~~]] ~~if '~~''uuid~~''' has~~ the same ~~active~~ group~~, otherwise [[~~FALSE]]		*"Is the script's prim in the same group as {{LSLP\|uuid}}?"
	~~\|spec~~		*"Is the group-uuid of the script's prim equal to {{LSLP\|uuid}}?"
	\|caveats=*~~Also~~ returns [[TRUE]] if the object is not set to a group (i.e. "(none)") and either the AV with the given key has no group active or the function is called with a [[NULL_KEY]]		\|spec=
			The group of the prim the script is in is...
			* The group the prim is set-to
			* The group the prim is deeded-to
			* The group the prim is otherwise owned by
			* If no group information is set, the group-uuid used for this is [[NULL_KEY]].

			The group of the {{LSLP\|uuid}} is...
			* If {{LSLP\|uuid}} is a prim (known to the region)...
			** and it is an attachment, the group of the owner*
			** The group the prim is set-to
			** The group the prim is deeded-to
			** The group the prim is otherwise owned by
			** If no group information is set, the group-uuid used for this is [[NULL_KEY]].
			* If {{LSLP\|uuid}} is an avatar (known to the region)...
			** The group of the avatar.
			** If no group information is set, the group-uuid used for this is [[NULL_KEY]].
			* Otherwise, treat {{LSLP\|uuid}} AS the group-uuid.
			** This means that instead of doing "Is the script's prim in the same group as {{LSLP\|uuid}}?", it becomes "Is the group-uuid of the script's prim equal to {{LSLP\|uuid}}?"
			Note: No group, prim, or avatar share the same uuid.

			In pseudocode:
			<source lang="lsl2">integer llSameGroup(key uuid){
			key group = getGroupKey(llGetKey());
			if(uuid == group)
			return TRUE;
			if(getGroupKey(uuid) == group)
			return TRUE;
			return FALSE;
			}</source>
			\|caveats=
			*Not so obvious is that it returns [[TRUE]] if the object is not set to a group (i.e. "(none)") and either the AV with the given key has no group active or the function is called with a [[NULL_KEY]].
	\|constants		\|constants
	\|examples=		\|examples=