PartOperation
*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.
Uma classe abstrata que todas as peças baseadas em modelagem sólida herdam.
Resumo
Propriedades
O nível de detalhe usado para renderizar a peça modelada sólida.
Um ângulo em graus que afeta a sombreamento suave de uma peça modelada sólida.
O número de polígonos neste modelo sólido.
Define se o PartOperation pode ser recolorido usando propriedades de cores herdadas.
Determina o nível de detalhe que a física da peça aderirá à sua malha.
Determina a representação geométrica usada para calcular forças e torques aerodinâmicos.
Determina se uma peça é imóvel pela física.
A velocidade angular da montagem da peça.
O centro de massa da montagem da peça no espaço mundial.
A velocidade linear da montagem da peça.
A massa total da montagem da peça.
Uma referência à parte raiz da montagem.
Determina se a peça vai interagir fisicamente com a simulação de áudio, semelhante a CastShadow para iluminação.
Determina o tipo de superfície para a face traseira de uma peça.
Determina o tipo de superfície para a face inferior de uma peça.
Determina a cor de uma peça.
Determina a posição e orientação do BasePart na mundo.
Determina se uma peça pode colidir com outras peças.
Determina se a peça é considerada durante as operações de consulta espacial.
Determina se Touched e TouchEnded eventos atiram na parte.
Determina se uma peça lança ou não uma sombra.
Descreve a posição mundial em que o centro de massa de uma peça está localizado.
Descreve o nome do grupo de colisão de uma peça.
Determina a cor de uma peça.
Indica as propriedades físicas atuais da peça.
Determina várias propriedades físicas de uma peça.
Usado para ativar ou desativar forças aerodinâmicas em peças e montagens.
O tamanho físico real do BasePart como considerado pelo motor de física.
Determina o tipo de superfície para a face frontal de uma peça.
Determina o tipo de superfície para a face esquerda de uma peça.
Determina um multiplicador para BasePart.Transparency que só é visível ao cliente local.
Determina se uma peça é selecionável no Studio.
Descreve a massa da peça, o produto de sua densidade e volume.
Determina se a peça contribui para a massa total ou inércia de seu corpo rígido.
Determina a textura e as propriedades físicas padrão de uma peça.
O nome de MaterialVariant .
Descreve a rotação da peça no mundo.
Specifica o deslocamento do pivô da peça de sua CFrame .
Descreve a posição da peça no mundo.
Tempo desde a última atualização de física registrada.
Determina quanto uma parte reflete a skybox.
Descreve a menor mudança de tamanho permitida pelo método Resize().
Descreve os rostos em que uma peça pode ser redimensionada.
Determina o tipo de superfície para o lado direito de uma peça.
A regra principal na determinação da parte raiz de uma montagem.
A rotação da peça em graus para os três eixos.
Determina as dimensões de uma peça (comprimento, largura, altura).
Determina o tipo de superfície para a face superior de uma peça.
Determina quanto uma peça pode ser vista através (o oposto da opacidade da peça).
Métodos
Substitui a geometria deste PartOperation com a geometria de outro PartOperation .
Aplique um impulso angular à montagem.
Aplique um impulso à montagem na montagem center of mass .
Aplique um impulso à montagem em posição especificada.
Retorna se as peças podem colidir entre si.
Verifica se você pode definir a propriedade de rede de uma peça.
Retorna uma tabela de peças conectadas ao objeto por qualquer tipo de articulaçãorígida.
Retorne todos os Juntos ou Restrições que estão conectados a esta Parte.
Retorna o valor da propriedade Mass de retorno.
Retorna o jogador atual que é o proprietário da rede desta parte ou nil no caso do servidor.
Retorna verdadeiro se o motor de jogo decidir automaticamente o proprietário da rede para esta parte.
Retorna a parte base de uma montagem de peças.
Retorna uma tabela de todas as BasePart.CanCollide peças verdadeiras que se intersectam com esta peça.
Retorna a velocidade linear da montagem da peça na posição dada em relação a esta peça.
Retorna verdadeiro se o objeto estiver conectado a uma parte que o manterá no lugar (por exemplo, uma parte Anchored), caso contrário, retorna falso.
Muda o tamanho de um objeto assim como usar a ferramenta de redimensionamento do Studio.
Define o jogador dado como proprietário da rede para isso e todas as peças conectadas.
Permite que o motor do jogo decida dinamicamente quem vai lidar com a física da peça (um dos clientes ou do servidor).
- IntersectAsync(parts : Instances,collisionfidelity : Enum.CollisionFidelity,renderFidelity : Enum.RenderFidelity):Instance
Cria um novo IntersectOperation a partir da geometria sobreposta da peça e das outras peças no matriz / listadado.
- SubtractAsync(parts : Instances,collisionfidelity : Enum.CollisionFidelity,renderFidelity : Enum.RenderFidelity):Instance
Cria um novo UnionOperation a partir da peça, menos a geometria ocupada pelas peças no matriz / listadado.
- UnionAsync(parts : Instances,collisionfidelity : Enum.CollisionFidelity,renderFidelity : Enum.RenderFidelity):Instance
Cria um novo UnionOperation a partir da peça, mais a geometria ocupada pelas peças no matriz / listadado.
Obtém o pivô de um PVInstance .
Transforma o PVInstance ao longo de todos os seus descendentes PVInstances de modo que o pivô agora está localizado no CFrame especificado.
Eventos
Eventos herdados de BasePartIncêndios quando uma parte para de tocar outra parte como resultado de um movimento físico.
Incêndios quando uma parte toca outra parte como resultado de um movimento físico.
Propriedades
RenderFidelity
Essa propriedade determina o nível de detalhe que a peça modelada sólida será mostrada em.Pode ser definido para os valores possíveis do Enum.RenderFidelity enum.
O valor padrão é Automatic , significando que o detalhe da peça é baseado na distância dela da câmera como descrito na tabela a seguir.
| Distância da Câmera |
|---|
SmoothingAngle
Essa propriedade representa um ângulo em graus para um valor de limite entre normais de face em uma parte modelada sólida.Se a diferença normal for menor que o valor, as normais serão ajustadas para suavizar a diferença.Enquanto um valor entre 30 e 70 graus geralmente produz um bom resultado, valores entre 90 e 180 não são recomendados, pois podem causar um efeito de "ombra" em uniões com bordas afiadas.
Observe que a suavização não afeta os normais entre diferentes materiais ou cores diferentes.
UsePartColor
Define se o PartOperation pode ser recolorido usando as propriedades BasePart.Color ou BasePart.BrickColor.Quando verdadeiro, toda a união será colorida como perante Color ou BrickColor .Quando falso, as peças na união manterão suas cores originais antes da operação de cebola ser realizada.
Métodos
SubstituteGeometry
Substitui a geometria deste PartOperation com a geometria de outro PartOperation .Isso torna mais fácil utilizar a geometria de uma operação de modelagem sólida como UnionAsync() , SubtractAsync() ou IntersectAsync() , mas manter propriedades, atributos, tags e filhos da parte principal, como Attachments , Constraints, ParticleEmitters, objetos leves, decalques e muito mais.Essa abordagem também contorna o potencial "flicker" de substituir completamente o original PartOperation por outro.
Observe que se você estiver chamando esse método em um PartOperation com filho Attachments ou Constraints , você deve calcular as instâncias afetadas com CalculateConstraintsToPreserve() , então soltar aquelas cujo pai recomendado seja nil .
Parâmetros
O PartOperation cuja geometria substituirá a geometria deste PartOperation .
Devolução
Amostras de código
local GeometryService = game:GetService("GeometryService")
local mainPart = workspace.PurpleBlock
local otherParts = { workspace.BlueBlock }
local options = {
CollisionFidelity = Enum.CollisionFidelity.Default,
RenderFidelity = Enum.RenderFidelity.Automatic,
SplitApart = false,
}
local constraintOptions = {
tolerance = 0.1,
weldConstraintPreserve = Enum.WeldConstraintPreserve.All,
}
-- Perform union operation in pcall() since it's asyncronous
local success, newParts = pcall(function()
return GeometryService:UnionAsync(mainPart, otherParts, options)
end)
if success and #newParts > 0 and mainPart:IsA("PartOperation") then
-- Set first part in resulting operation as part to use for substitution
-- First part is simply an option; this can be any PartOperation
local substitutePart = newParts[1]
-- Reposition part to the position of main part
substitutePart.CFrame = mainPart.CFrame
-- Calculate constraints/attachments to either preserve or drop
local recommendedTable = GeometryService:CalculateConstraintsToPreserve(mainPart, newParts, constraintOptions)
-- Substitute main part's geometry with substitution geometry
mainPart:SubstituteGeometry(substitutePart)
-- Drop constraints/attachments that are not automatically preserved with substitution
for _, item in pairs(recommendedTable) do
if item.Attachment then
if item.ConstraintParent == nil then
item.Constraint.Parent = nil
end
if item.AttachmentParent == nil then
item.Attachment.Parent = nil
end
elseif item.WeldConstraint then
if item.Parent == nil then
item.WeldConstraint.Parent = nil
end
end
end
-- Destroy other parts
for _, otherPart in pairs(otherParts) do
otherPart.Parent = nil
otherPart:Destroy()
end
end